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Preface 


This publication contains a summary of ACF/VTAM Release 
3 reference information which is presented under four major 
headings: 


Part 1. Operation 
Part 2. Installation 
Part 3. Programming 


Part 4. SNA Reference Data 


Refer to the Contents for a list of the specific topics included 
in each part of the manual. 


Supplemental publications include but are not limited to: 


e General Information: 
ACF/VTAM General Information: Introduction, 
GC27-0462 | 
ACF/VTAM General Information: Concepts, GC27-0463 


@ Planning and Installing ACF/VTAM: 
ACF/VTAM Planning and Installation Reference, 
SC27-0584 


e Writing Application Programs: 
ACF/VTAM Programming, SC27-0449 


@ Operating ACF/VTAM: 
ACF/VTAM Operation, SC27-0446 


@ Messages: 
ACF/VTAM Messages and Codes, SC27-0470 


e Diagnosis: 
ACF/VTAM Diagnosis Guide, SY38-3020 (VSE), 
SY38-3029 (OS/VS) 
ACF/VTAM Diagnosis Reference, _Y38-3022 (VSE), 
LY38-3027 (OS/VS) 
ACF/VTAM Data Areas, LY38-3026 (VSE), LY38-3030 
(OS/VS) 
ACF/VTAM Logic: Multisystem Networking Facility, 
LY38-3023 
ACF/VTAM Logic: Encrypt/Decrypt Feature, 
LY38-3025 
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PART 1. 


OPERATION 


ACF/VTAM Operator Commands 


DISPLAY Commands?! 


DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 


DISPLAY 


DISPLAY 


DISPLAY 


DISPLAY 
DISPLAY 
DISPLAY 


DISPLAY 


DISPLAY 
DISPLAY 


NET,APPLS[,ACTIEVERY|INACT] 
NET,BFRUSE 

NET,CDRMS? [,ACTIEVERY|IINACT] 
NET,CDRSCS? [,ACTIEVERYIINACT] 
NET,CLSTRS[,ACTIEVERY|INACT] 
NET,ID=name? [,ACTIEVERY|INACT|NONE] 
NET,LINES[,ACT|EVERY|INACT|NONE] 
NET,MAJNODES 


NET,NCPSTOR,|ID=ncpname,ADDR=address 
[LENGTH=n/32] 


NET,PATHTAB[,ADJSUB=subarea|DESTSUB= 
subarea] 


NET,PATHS,ID=switched physical unit name 
NET,PENDING 


NET,ROUTE,DESTSUB=subarea 
[ COSNAME=name|ER=n|ER=ALL|VR=n] 
[TEST=YES|NO] 


NET,STATIONS[,1D=major node name] 
[, ACTIEVERY|INACT] 


NET, TERMS[,ACTIEVERY|INACT] 
NET,U,*1D=tso user-id 





1The following abbreviations may be used: 


ACT=A INACT = | 
DISPLAY =D NONE =N 
EVERY =E PATHS =P 


2 Applies only to multiple-domain networks. 
3 Does not apply to application program major nodes. 
* Applies only to MVS with TSO/VTAM. 











EXEC Command! 
Enter EXEC PROC=procname 


and, if prompted, one or more of these start 
options: 


CDRSCTI=n/480 
COLDIWARM 
CONFIG=xx|00|name 
HOSTSA=n|1 
lOINT=n|180 
ITLIM=n|0 
LIST=xx|00 
MAXAPPL=n/10 
MAXSUBA=n115 
MSGMOD=YES/|NO 
NODELST=name 
SONLIM=([m|60] [,n|30] ) 
SSCPID=n 
SUPP=[NOSUP|INFO|WARN|NORMISER] 
TNSTAT[,CNSLINOCNSL[,TIME=n|60] \ 
ee 
TRACE |NOTRACE,TYPE=BUF,|D=nodename[,EVERY|E] 
TRACE|NOTRACE,TYPE=I0,1D=nodename[,EVERYIE] 
TRACE|NOTRACE,TYPE=LINE,!I D=linename 
TRACE|INOTRACE,TYPE=SMS,ID=VTAMBUF 
TRACE|NOTRACE,TYPE=TG,|ID=linename 
TRACE, TYPE=VTAM[,MODE=INT|EXT] 
[,OPTIONS=(options)? | 
(API,MSG,PIU)|ALL] 
[,SIZE=nnn/2] 
NOTRACE,TYPE=VTAM = 
USSTAB=name|ISTINCNO 
VFBUF=vbsz 
VPBUF=vbsz 
VTAMEAS=n1404 | | 
poolname=(baseno,bufsize,slowpt,xpanno,xpanpt) 


1 Applies to VSE only. 

OS/VS users should use the START command. 
2 Options may be one of the following: 

API, CiO, LOCK, MSG, PIU, PSS, SMS, SSCP. 
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HALT Commands? 
HALT NET[,CDLINK?=ACTI|INACT] 
HALT NET,QUICK[,CDLINK?=ACTI|INACT] 


HALT NET,CANCEL? 


1HALT or Z may be used. 


2 Applies only to multiple-domain networks. 
3 Applies to OS/VS only. 


| 


MODIFY procname,? ATTACH? ,ID=name 


MODIFY Commands? 


MODIFY procname,? CDRM‘4=(new cdrm[,old cdrm] ) 
[,1D=cdrsc major node name|cdrsc 
minor node name] 


MODIFY procname,? CSALIMIT’ =(niO[,F] ) 
MODIFY procname,? DETACH?,ID=name 


MODIFY procname,? DUMP,ID=ncp major node name 
[, DUMPSTA=name] [,DYNA|RMPO] 


MODIFY procname,? ENCR®= { OPTIREQD } ,1D=logical 
unit name 


MODIFY procname,? IMR,!D=link station or physical 
unit name 
[,OPT=ACTIINACT] 
[,RECLIM=n110] 


MODIFY procname,? IOPD[,IOINT=n] 


MODIFY procname,”? LL2,|ID=name’ [,CANCEL|CONT| 
NTRANS=10Im] 
[,DATA=data] [, NFRAMES=n11] i 


MODIFY procname,? MSG?,ID=subtask name 
MODIFY procname,? MSGMOD= {YESINO } 


MODIFY procname,? NEGPOLL=number of responses,|D= 
line name 


MODIFY procname,? NOTNSTAT 


1MODIFY or F may be used. 
2In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 
The procname operand is the name of the cataloged 
procedure by which ACF/VTAM was started. 
3 Applies to VSE only. | i; 
* Applies only to multiple-domain networks. | 
5 Applies to MVS only. ~ 
© Applies to Encrypt/Decrypt Feature only. 
71D=name may be the PU name, or the link station 
name for the NCP. 
4 





MODIFY Commands! (Continued) 


MODIFY procname,? NOTRACE,TYPE={BUF|IO},ID=node 
name[,EVERY? ] 


MODIFY procname,? NOTRACE, T YPE= { LINEISMS| 
TG|TSO*} ,1D=node name 


MODIFY procname,? NOTRACE, TYPE=VTAM 
[, OPTION=ALLIoption| 
(option, .. . ,option® )|END] 


MODIFY procname,*? POLL=number of seconds, 
1D=line name 


MODIFY procname,? SESSION=n,ID=line name 


MODIFY procname,? —— 
SER 


MODIFY procname,? TEST 


MODIFY procname,? TNSTAT[,CNSLINOCNSL] 
[, TIME=n] 


MODIFY procname,? TPRINT® 

and if prompted, one or more of these trace print options: 

CANCEL 

PRINT 

BUF=ALL 

BUF=namel[,...,name] 

CLEAR=YES|NO 

INTERVAL=beginning time? |(,end time) |beginning time, 
end time) 

IO=ALL 


1 Modify or F may be used. 

2In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 

3 EVERY or E may be used. 

4 Applies to MVS only. 

> Options may be one or more of the following: 
API, ClO, LOCK, MSG, PIU, PSS, SMS, SSCP. 

© Applies to VSE only. 

7 Specify the time as yy.ddd/hh:mm:ss, yy.ddd, or 
hh:mm:ss. 


Modify Commands! (Continued) 


1O=namel[,...,name] 
LINE=ALL 

LINE=name 

TNST=ALL 
TNST=name[,...,name] 


MODIFY procname,? TRACE, TYPE= {BUFIIO} ID=name? 
[EVERY]? 


MODIFY procname,? TRACE,TYPE= 
{LINE|SMSITG/TSOS} ,1D=name? 


MODIFY procname,? TRACE,TYPE=VTAM 
[,MODE=INTIEXT] 
[,OPTION=option| 
(option, ... ,option® )|ALL] 
[,SIZE=nnn] 


1 MODIFY or F may be used. 

2In VSE, use NET. 
In OS/VS1, use procname.Pnn. 
In MVS, use procname. 

31D=name specifies the name of the resource for which 
tracing is to be done. This operand does not apply for 
TYPE=VTAM. 


Names of various types of resources can be specified, de- 
pending on the value of the TYPE operand. 


For TYPE=BUF or TYPE=IO 

Any of the following names can be specified with the 
EVERY option to trace message activity with the named 
resource, if applicable, and all of the resource’s subordinate 
nodes: 


@ Thename of a major node 

@ Thename of a line group 

e Thename of a line 

@ The name of a physical unit (including switched and 
channel-attached SNA physical units) 


Any of the following names can be specified to trace 
message activity with the named resource: 


e VTAM (for a trace of all SSCP-FMCB sessions) 
@ Thename of an NCP 
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@ Thename of a physical unit (including switched and 
7 channel-attached SNA physical units) 
J e@ Thename of a logical unit (including application 
programs) 
@ The name of a channel-attached non-SNA terminal 
@ Thename of a CDRM (only in a multiple-domain 
7 network) 
} @ The name of a CDRSC (only in a multiple-domain 
: network) 


For TYPE=LINE 
The ID operand spec:-ies the name of the line for which 
tracing is to be done. 


For TYPE=SMS 
ID=VTAMBUF must be specified for an SMS trace. 


For TYPE=TG 

The ID operand specifies the name of a line currently 
within the transmission group to be traced. All the lines 
in the transmission group are traced as if they were a 
single logical line. 


For TYPE=TSO 
The ID operand specifies the TSO user 1D for which tracing 
is to be done. 

* EVERY or E may be used. 

> Applies to MVS only. 

© Options may be one or more of the following: API, CIO, 
LOCK, MSG, PIU, PSS, SMS, SSCP. 








START Command! 


Enter START? { procname aE , (options,. . .)] 
procname.Pnn? 


eee 


where the start options may be one or more of the following: 

CDRSCTI=n|480 

COLD|IWARM 

CONFIG=xx|O0|name 

CSALIMIT=n|04 

DLRTCB=n\|8°_ 

DLRTCB=n|32* 

HOSTSA=ni1 

IOINT=n/|180 

ITLIM=n|0 

LIST=xx|00 

MAXAPPL=n|10 

MAXSUBA=n|15 

MSGMOD=YES|NO 

NODELST=name 

SONLIM=([mi60] [,n|30] ) 7 

SSCPID=n 

SUPP=[NOSUP|INFO|WARNINORM|SER] 
TNSTAT[,CNSLINOCNSL] [,TIME=n|60] 
NOTNSTAT 

TRACE|INOTRACE,TYPE=BUF,ID=nodename[,EVERY*°* ] 

TRACE|NOTRACE,TYPE=I0O,ID=nodename [EVERY ® ] 

TRACE|INOTRACE,TYPE=LINE,|ID=linename 

TRACE|NOTRACE,TYPE=SMS,1D=VTAMBUF 

TRACE|NOTRACE,TYPE=TG,1 D=linename 

TRACE|INOTRACE,TYPE=TSO,1D=tso-userid 
TRACE,TYPE=VTAM[,MODE=INTIEXT] 

[,OPTIONS=(options)| 
(API,MSG, PIU® )|ALL] 
[,SIZE=nnn/2] 

NOTRACE,TYPE=VTAM 


1 Applies to OS/VS only. 

VSE users should use the EXEC command. 
2START or S. oe ~ 
3 Applies to OS/VS1 only. 7 
* Applies to OS/VS2 (MVS) only. 

SEVERY or E. 
© Options may be one or more of the following: 
API, ClO, LOCK, MSG, PIU, PSS, SMS, SSCP. 
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START Command! (Continued) 


) USSTAB=name|ISTINCNO 
aa VTAMEAS=n/404 
poolname=(baseno,bufsize,slowpt,F,xpanno,xpanpt) 


) 1 Applies to OS/VS only. 
VSE users should use the EXEC command. 


VARY Commands! 


VARY NET,ACQ,ID=name 
| ,ACT [, LOGMODE=logon mode name] 
{[,_OGON=application program name or 
cdrsc name 
[ SCOPE=ALL|COMPIONLY|U] 


VARY NET,ACT,ID=name 
[, ANS? =ON|OFF] 
[, DUMPSTA=name] 
[, LOAD=YES|NO|U] 
[, LOADSTA=name] 
[, LOGMODE=logon mode name] 
[,LOGON=application program name or 
cdrsc name? ] 
[, RNAME=namel](namel1,. ..,name13)] 
[, SCOPE? =ALLI|COMPIONLY|U] 
[, U=channel device name] 
[,WARM* ] 


1VARY or V. 

2 Applicable when using SDLC only. 

3 Applies only to multiple-domain networks; a CDRSC name 
must be an application program in another domain. 

.*Note that WARM and SCOPE cannot be specified on the 
same command. If both are specified, the command fails. 

10 


eed 


VARY Commands’ (Continued) 


J The following table indicates each resource type for which 

7 the command is valid and which operands can be used on the 
command. A bullet (@) indicates that the operand applies to 
that resource and an S indicates that the operand can be 
specified for sifting to subordinate resources. An M indicates 

} that the operand applies to that resource only in certain 

Migration cases. 











a 8 | 

3/3 hg 

E|3 ~|,/3]3 

Ss o}'e = a | cle 

3/25) 8 BIS) ty} 12) 3 

sel<(ais|z|e| |s 2f5|3|8/3|318|3 

SlE|E/Eelsis| (lel -lel_(Stelaiglelclals 

glslelsis|2i2| /elsig/s/1Z/E (cle (siege 

SlelZiZiZiZis] [Sl BlSlsl2 B18] Bis l2lelola 

BR) |S/G)=12) [sels BigleiZleialsisiZig 

#181 8) 8) 818/ $18 15/3 sletg| zig sisal alas 
MINERS FiSl3(3(Si88ioisizlsiel3igiz(glF 18191918 
= Lefol elo] elo] ele lolofe lol elo] elo] elo] elo] | 
ANS= ao er Te 
oumesta= | | tT tt tt te} TT TT TE TT | 
LOAD= She ee CRRA RRRES EEE 
Loapsta= | {| [| [TT tT fet PT PTE TT Te 
Locmove= | | |sjsjelsiels|sisis|sle{sisie] | | | | | 
Locon= | | {s{sfe[sfels|s|s{s|sfe[s|s{e] | | | | 
BNAMEs et yh teh Me oe 
SCOPE= opteceete| tele fe | te eet ett 
U= Pat see te ee hel or ae tee ee 
WARM esos Wises ilsicler 
1VARY or V. 


? Applies only to multiple-domain networks; a CDRSC name 
must be an application program in another domain. 
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VARY Commands?! (Continued) 


4 

VARY NET,ANS2= { ONIOFF } ‘ID=line name 

[, ACT] is 
VARY NET,DRDS,!D=drname 
VARY NET, INACT? ,ID=name 

[,CDLINK=ACTIINACT? ] 

[FINAL] 

LIFIRI 

[,RMPO] 


The following table indicates each resource type for which 
the command is valid and which operands can be used on 
the command. A bullet (e) indicates that the operand ap- 
plies to that resource. An I, F, or R in the table indicates 
what value is substituted if an F or R operand is specified 
for a resource to which it does not apply. 


3\3 
2\2 ; 
5|5 32 
= |£\</2lz|2\3 : 
S/5/£/* 5 = is a 
E| Ell a/sizie| |e 3/2/3|5{s\3| 813 
8/813) S)aia\<| [5 ~|2/8| clei Si2|2 
aja isi e\ 8\2\2 3/2 +l] 3] S13] Sle] sls] 
cle a) 0 O/S/S(ElE(S/£/ S/S 91 Sisal s 
2) 2/3)/S)S|5)5 Blel el lsigilgizlelsisl=l= 
SSS ZZ) Sela) Sigel si slalsls/BlZ = 
vner, inact) £| 218) 8| Si sisi8(sis( =| Siaie|s 2\cla|x\a\a 
: 41215) S/S S/S i Sisal sielsi dl Z| | E/8/813/8 
(0- fale lela fale| el efelelelelelelelelololofefe| 
CDLINK= od ed = A ale ek dha ae h. ase Wome sda 
FINAL Bese CR REE 
| pole leleolelelelelelelelelelelelo| lelelele| a 
F pole [tleole|tlelelelelefelel {Riel [elelele| 
R PFIFiile/FltlelelFlFlelelFl[iie(Fl [FIFIFIF | 
RMPO este Wee ae slows SNE sie fea epee or 
1WARY or V may be used. ae 
2 Applicable when using SDLC dial only. fo 
3 Caution: TSO/VTAM users should never use this NS gt 


command to deactivate a TSO user memory while 
TSO/VTAM is operating. 

* Applies only to multiple-domain network. 
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VARY Commands? (Continued) 





VARY 

VARY 
J 

VARY 
5 VARY 

VARY 


NET,INOP { ,1D=line name[,END] } 
,1D=physical unit name 


NET,LOGON=application program name or 
cdrsc name? ,ID=name 
[, LOGMODE=logon mode name] 


NET,PATH=USE|NOUSE 
{ ,PID=n,|D=physical unit name } 
,GID=n,|D=switched major node name 


NET,REL,|ID=name 
[ CDLINK=ACTI|INACT?] 
[,1] 


NET,TERM, 
,LU1=LU name[,LU2=LU name] 
,PLU=primary LU name[,SLU=secondary 
LU name 
,9|D=session identifier 
,5LU=secondary LU name[,PLU=primary 
LU name] 
[,NOTIFY=YESINO] 
[,SCOPE=ACTIALLIO] 
[, TYPE=COND|UNCONDI|FORCE] 


) 1VWARY or V may be used. 
2 Applies only to multiple-domain networks; a CDRSC name 
must be an application program in another domain. 
3 Applies only to mulitple-domain networks. 
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Resource Status Codes 


The status of an ACF/VTAM network resource is contained 
in the RDT prefix (RPRE) for each resource. The resource’s 
status is broken down into its current state and the desired 
state. These two values are contained at displacements hex 
38 (RPRCURST — current state) and hex 3A (RPRDESST — 
desired state) in the RPRE. The hexadecimal values in these 
two fields correspond to the status of the resource, as shown 
in the following table. The 5-character state acronym also 
appears in some ACF/VTAM messages in response to an 
operator DISPLAY NET, |D=resourcename command. See 
ACF/VTAM Operation and ACF/VTAM Messages and Codes 
for more information about the DISPLAY command and the 
messages that respond to it. 


The classification of states into the following major cate- 
gories may aid in deciding if a problem exists. 


Category Meaning 


Final ACF/VTAM has no further processing to 
do for the node. 


Short Transient The node is awaiting completion of an 
operation (such as I/O) that will take a 
relatively short time to complete. If 
the node remains in this state for a long 
time, there is probably a hardware or 
software error. 


Long Transient The node is awaiting completion of an 
operation that will take a relatively long 
time to complete. If the node remains in 
this state for an unreasonable length of 
time, there is probably a hardware or 
software error. 
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Category 


y Suspended 


Internal 





Resource Status Codes 


Meaning 


This node is awaiting processing of an- 
other node. When the awaited processing 
has completed, the status of this node 
should change. If the awaited processing 
completes and this node remains in this 
state, then there is probably a software 
problem, 


This state is used within ACF/VTAM to 
direct processing. It should never be dis- 
played. If it is, then there is probably a 
software problem. 


The first byte of RPRCURST and RPRDESST represents 
the resource status categories: 


= Value (Hex) 


00 
01 
02 
03 
04 
05 


) 06 


Current State Desired State 
Category Category 
Inactive Inactive 
Pending inactive Not used 
Connectable Connectable 
Reactivate Reactivate 
Pending active Not used 
Active Active 
Routable Routable 


The second byte of RPRCURST and RPRDESST gives the 

specific resource status. The following table shows the two 

bytes in combination (for example, value hex 0001 indicates 
-_ } a category of 00 and a specific code of 01). 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


ACTIV 
(0505) 


APEER 
(0501) 


CONCT 
(0200) 


CTD(1) 
(043D) 


16 


Category 


Final 


Final 


Final 


Suspended 


Resource Status 


Active: The resource is in the 
active state. 


Backup Link Station Active: The 
resource is an active backup link 
station to which a subarea node is 
attached. 


Connectable: A VARY NET,ACT 
command has completed for a 
switched or local physical or logical 
unit, or for an application program. 
A dial-in or dial-out request will be 
honored, but the resource is not 
active at this time. For application 
programs, an OPEN has not yet 
been issued. For a channel-attached 
resource, the device has not been 
powered on. 


Contacted (1): A link station was 
being activated and a Contacted 
request has been received. Because 
the NCP contacted is also being 
activated, the activation of the link 
station is suspended while the NCP 
activation proceeds. Activation 
processing for the link station will 
resume before activation of the 
NCP completes. 


aa 


Se eet 


Abbre- 


| viation 
" (Hex 
Value) Category 


CTDER Suspended 
(041D) 





CTRQI Suspended 
(043A) 


Resource Status Codes 


Resource Status 


Contacted Error: A node, either 
a link station or a peripheral 
physical unit was being activated 
and a Contacted request was 
received indicating the Contact 
operation failed. For a peripheral 
PU, a request to deactivate the 
resource has been scheduled. Fora 
link station, if the NCP it is trying 
to contact is also being activated, 
the link station activation will be 
suspended while the NCP activa- 
tion proceeds. Activation proc- 
essing for the link station will 
resume before activation of the 
NCP completes. A second contact 
failure will cause deactivation of 
the link station. 


Contacted (2) Request IPL: A 
node, either a link station ora 
peripheral PU, is being activated 
and the Contacted request indicates 
that reload is required. Fora 
peripheral PU, a request to de- 
activate the resource has been 
scheduled. For a Jink station, if 
the NCP it is trying to contact is 
also being activated, the link station 
activation will be suspended while 
the 3705 activation proceeds. 
Activation processing for the link 
station will resume before activa- 
tion of the NCP completes. A 
second Contacted request indi- 
cating that reload is required will 
cause deactivation of the link 
station. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


CT1NS 
(O40F) 


DALUC 
(O11E) 


DAPUC 
(011F) 


DEFND 
(0001 ) 
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Category 


Suspended 


Suspended 


internal 


Short 
Transient 


Resource Status 


Contact (1) Not Sent: A link sta- 
tion reached the point in its activa- 
tion where a Contact request 
should be sent, but the NCP to be 
contacted was not in a suitable 
state. The link station’s activation 
will be suspended while the NCP’s 
activation proceeds. Activation 
processing for the link station will 
resume before activation of the 
NCP completes. 


DACTLU Complete: A DACTLU 
has been sent and the response 
received, but some higher-level 
node recovery processing has 
started. This node will remain in 
this state until the higher-level 


~ process redrives it. 


DACTPU Complete: A DACTPU 
has been sent as the result of a 
force deactivate or force reactivate 
command, and either the response See 
was received or in the case of a 

3705, a route failed and a DACTPU 

request was received. 


Defined: A VARY NET, ACT 

command is being processed for a 

major node and the RDT segment 

has just been built. The major node 

and its subnodes are known to P 
ACF/VTAM. The activation has (3 
been suspended while the proces- ee 
sing of the command moves from 

one internal ACF/VTAM dis- 

patching point to another. 


ie 
Vv 


Abbre- 
viation 
(Hex 
Value) Category 
DUMPC 
(011B) 


Suspended 


FDSCC 
(0445) 


Internal 


HLACC 
(042D) 


Internal 


HLACF 
(0409) 


Internal 


Resource Status Codes 


Resource Status 


Dump Complete: A link station 
was used to dump an NCP and the 
dump is complete, but the recovery 
or deactivation of the NCP has not 
reached the point where link 
stations adjacent to that NCP are 
processed. For a recovery, that 
point is when the NCP’s load/dump 
procedure status is RESET. Fora 
deactivation, that point is when the 
NCP’s status is PRSET. 


Force Discontact Complete: A 
DISCONTACT has been sent as 

a result of a force deactivate or 
force reactivate command and the 
response to the DISCONTACT 
has been received. 


Higher-Level Activate Complete: 
The resource is being activated and 
its higher-level node has completed 
activation. For example, a local PU 
or LU is being activated, and the 
activation of the associated channel 
(such as PUB or UCB allocation) 
has completed. The activation of 
the resource is about to begin. 


Higher-Level Activate Failed: The 
resource was being activated, and 
activation of its higher-level node 
failed. For example, a local PU or 
LU was being activated, and PUB or 
UCB allocation has failed for its 
associated channel. A deactivate 
request was scheduled for the local 
PU or LU. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


lIINOP 
(0005) 


INACS 
(0006) 
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Category 


Final 


Final 


Resource Status 


Inactive (Inoperative): The 
resource has been deactivated by 
an INOP request or a forced 
deactivation. 


Inactive with Sessions. If the 
resource is an LU, the node is in 
the inactive state, but may have 
active sessions. There is no LU- 
SSCP session, but the LU may 
have active LU-LU sessions. This 
state can occur when a cross- 
domain resource is made a same- 
domain resource as part of the 
takeover of the resources of an 
SSCP that failed. 


If the resource is a CDRM, the node 
is in an inactive state, but it sup- 
ports active cross-domain LU-LU 
sessions. In this state, there is no 
SSCP-SSCP session, but the CDRM 
may be supporting active cross- 
domain LU-LU sessions. This state 
can occur when: 


1. The virtual route used by the 
SSCP-SSCP session is inopera- 
tive or has been deactivated by 
a DACTVR (FORCE) 


2. Activate CDRM contention 
has occurred 


3. An unrecoverable error has been 
detected for the SSCP-SSCP ses- 
sion. The cross-domain active 
session, which used the SSCP- 
SSCP session to setup, will 
remain intact. 


Abbre- 


) viation 
2 (Hex 


Value) Category 


INACT Final 

) (0003) 
INOP Suspended 
(0441) 


INVAP Internal 
(0417) 


LLOED Suspended 
(043B) 


Resource Status Codes 


Resource Status 


Inactive: The resource is inactive. 


Inoperative: An INOP request, 
route failure, or force reactivate 
command ts being processed. 
Active user sessions have been ter- 
minated, and the resource is about 
to be reactivated, but must wait for 
a higher level node. 


Invalid ACTPU Response: A node, 
such as a communication controller 
or PU, is being activated, and the 
ACTPU request has been sent, but 
the associated response is invalid. 
Examples of invalid responses are: 
when the response unit has invalid 
format or indicates the PU is not in 
COLD or ERP state, or the resource 
has been loaded, and the contents 
ID is not the expected value. A 
request to deactivate the resource 
was scheduled. 


Lower Level Queued: A VARY 
NET, ACT command is being proc- 
essed for a communication con- 
troller and the RDT segment has 
just been built. The network names 
of the major node and its subnodes 
are known to ACF/VTAM. At least 
one of the subnode link stations has 
been queued on another link 
station queue, because it is an 
operand of the RNAME= keyword 
on the second communication 
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Resource Status Codes 


Abbre- 

viation a 
(Hex 

Value) Category Resource Status 


controller’s VARY NET, ACT com- 

mand. The activation of the com- wee 
munication controller has been 

suspended while the processing of 

the command moves from one 

internal ACF/VTAM dispatching 

point to another. 


NACDR Internal Negative Activate CDRM Response: 

(042F) A CDRM is being activated and the 
Activate CDRM request was sent, 
but the associated response was 
negative (the request failed). A 
request to deactivate the CDRM w 
has been scheduled. 


NACTL Internal Negative Activate LU Response: A 

(0410) node, such as an application pro- 
gram or other LU was being activa- 
ted, and the Activate LU request 
was sent, but the associated re- 
sponse was negative (the request 
failed). A request to deactivate the oe 
resource was scheduled. 


NACTP Internal Negative Activate PU Response: A 

(0412) node, such as a communication | 
controller or PU, was being activa- Se 
ted and the Activate PU was sent, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the resource 
was scheduled. 
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Abbre- 
viation 
(Hex 

Value) Category 
NADLK Internal 


(0423) 


NADST 
(0420) 


Internal 


NALNK Internal 


(0415) 


NANNA Internal 


(0431) 


Resource Status Codes 


Resource Status 


Negative Add Link Response: A 
channel link was being activated 
and an Add Link request was sent 
to the appropriate PU services. 
However, the associated response 
was negative and the request failed. 
A request to deactivate the resource 
was scheduled. 


Negative Add Link Station Re- 
sponse: A channel link station was 
being activated and an Add Link 
Station request was sent to the host 
PU. However, the associated 
response was negative and the 
request failed. A request to deacti- 
vate the resource was scheduled. 


Negative Activate Link Response: 
A line was being activated, and the 
Activate Link request was sent, but 
the associated response was nega- 
tive (the request failed). A request 
to deactivate the line has been 
scheduled. 


Negative Allocate Node Network 
Address: A node, such as a DR- 
added PU or LU, was being acti- 
vated, and the Request Network 
Address Assignment request was 
sent to the appropriate PU services, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the resource 
was scheduled. 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category 


NASNA Internal 
(0426) 


NCONO Internal 
(0400) 


NCONT Internal 
((041C) 


NEVAC Final 
(0004) 
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Resource Status 


Negative Allocate Subnode Net- 
work Addresses: A node, such as 
a local or switched physical unit, is 
being connected and the Request 
Network Address Assignment 
request has been sent to the appro- 
priate PU services. However, the 
associated response was negative 
and the request failed. A request to 
disconnect the resource was 
scheduled. 


Negative Connect Out Response: A 
node, such as a local or switched 
physical unit, was being connected 
and the Connect Out request was 
sent to the appropriate PU services, 
but the associated response was 
negative and the request failed. A 
request to disconnect the resource 
was scheduled. 


Negative Contact Response: A 
node, such as a link station or PU, 
was being activated and the Contact 
request was sent, but the associated 
response was negative (the request 
failed). A request to deactivate the 
resource has been scheduled. 


Never Activated: The resource 
has never been activated. 


i 
Ne es 


J 


Abbre- 
viation 
(Hex 
Value) Category 
NLOAD 
(043C) 


Internal 


NNAUV 
(0403) 


Internal 


NSARV 
(041A) 


Internal 


NSDT 
(0428) 


Internal 


Resource Status Codes 


Resource Status 


Negative Load Response: An NCP 
was being activated and a Load 
Request was sent to the appropriate 
PU services, but the associated 
response was negative and the 
request failed. A request to deacti- 
vate the NCP was scheduled. 


Negative Set LU Control Vector 
Response: A node, such as a 
switched or dynamically added 
logical unit, was being connected 
and the Set Control Vector request 
with the LU Control Vector was 
sent, but the associated response 
was negative and the request failed. 
A request to disconnect the resource 
was scheduled. 


Negative Set Subarea Routing 
Control Vector: A node, such as 

a link station, was being activated 
and the Set Control Vector request 
with the Subarea Routing Control 
Vector was sent, but the associated 
response was negative and the re- 
quest failed. A request to deacti- 
vate the resource was scheduled. 


Negative Start Data Traffic Re- 
sponse: A communication con- 
troller was being activated and the 
Start Data Traffic request was sent, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the communi- 
cation controller was scheduled. 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category 


NSNCP Internal 


- (042E) 


NSSSV Internal 
(0405) 


NSTD Internal 
(042A) 


NVYLM Internal 
(0436) 
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Resource Status 


Negative Switch to NCP Response: 
A PEP link was being activated, and 
the SW to NCP request was sent, 
but the associated response was 
negative, and the request failed. A 
request to deactivate the PEP link 
was scheduled. 


Negative Set SDLC Secondary 
Station (SSS) Control Vector: A 
node, such as a DR-added PU, or 

a switched PU, was being con- 
nected, and the Set Control Vector 
Request with the SSS control 
vector was sent, but the associated 
response was negative and the 
request failed. A request to dis- 
connect the node was scheduled. 


Negative Set Time and Date 
Response: A node, such as a com- 
munication controller, was being 
activated, and the Set Time and 
Data request was sent, but the 
associated response was negative, 
and the request failed. A request to 
deactivate the node was scheduled. 


Negative Operator Query (VFLYM) 
Response: The resource was being 
activated and the response to the 
ACF/VTAM message IST3611! or 
5D61A was to terminate the NCP’s 
activation. A request to deactivate 
the resource has been scheduled. 








Abbre- 

viation 

(Hex 

Value) Category 
PABCN Short 
(010B) Transient 
PABCO Short 
(0116) Transient 
PACDR _Long 
(0430) Transient 


Resource Status Codes 


Resource Status 


Pending Abandon Connection 
Response: A node, such as a 

local or switched PU, is about to 
become disconnected. The 
Abandon Connection request has 
been sent to the appropriate PU 
services, but the associated response 
has not been received. 


Pending Abandon Connect Out 
Response: A node, such as a local 
or switched PU, is being discon- 
nected and the Abandon Connect 
Out request has been sent to the 
appropriate PU services, but the 
associated response has not been 
received. 


Pending Activate CDRM Response: 
A CDRM is being activated and the 
Activate CORM request has been 
sent, but the associated response 
has not been received. The sending 
of this request may have to wait 
for the availability of a virtual 
route. If one or more explicit 
routes are operative, this should 

be a short transient state while 
route activation proceeds. If no 
routes are operative, this may be 

a long transient state while ACF/ 
VTAM waits for connectivity to 

be established along the route. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PACTL 
(0411) 


PADLK 
(0421) 


PADST 
(0419) 


PALNK 
(0416) 


PALUC 
(0434) 
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Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


“N 


-_~ 
™ 


Short 
Transient 


Resource Status 


Pending Activate LU Response: A 
node, such an an application pro- 
gram or other logical unit, is being 
activated and the Activate LU re- 
quest has been sent, but the associ- 
ated response was not received. 


Pending Add Link Response: A 
channel link is being activated and 
an Add Link request was sent to 
the appropriate PU services, but 
the associated response has not 
been received. 


Pending Add Link Station Re- 
sponse: A channel link station is 
being activated and an Add Link 
Station request was sent to the 
appropriate PU services, but the 
response has not been received. 


Pending Activate Link Response: 
A line is being activated, and the 
Activate Link request has been 
sent, but the associated response 
was not received. 


Pending Activate LU Cleanup 
Response: An active LU is under- 
going recovery processing. An 
ACTLU request has been sent, but 
the associated response has not 
been received. 











Abbre- 
viation 
(Hex 
Value) Category 
PANNA Short 
s ) (0432) Transient 
PAPU1 Long 
(0413) Transient 
; } PAPU2 Long 
7 (0425) Transient 


Resource Status Codes 


Resource Status 


Pending Allocate Node Network 
Address: A node, such as a dy- 
namically added physical unit or 
logical unit, is being activated and 
the Request Network Address 
Assignment request has been sent 
to the appropriate PU services, but 
the associated response was not 
received. 


Pending Activate PU (1) Response: 
An NCP is being activated, and may 
need to be loaded, ACTPU was 
sent, but the associated response 
has not yet been received. The 
sending of this request may have to 
wait for the availability of a virtual 
route. If one or more explicit 
routes are operative, this should be 
a short transient state while route 
activation proceeds. !f no routes 
are operative, this may be a long 
transient state while ACF/VTAM 
waits for connectivity to be 
established along the route. 


Pending Activate PU (2) Response: 
A physical unit is being activated. 
ACTPU has been sent, but the as- 
sociated response has not yet been 
received. For a subarea PU, the 
sending of this request may have to 
wait for the availability of a virtual 
route. If one or more explicit 
routes are operative, this should ef- 
fectively be a short transient state 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PASNA 
(0427) 


PCONO 
(0401) 


PCON1 
(041E) 


PCON2 
(0422) 
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Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Resource Status 


while route activation proceeds. If 
no routes are operative, this may be 
a long transient state while ACF/ 
VTAM waits for connectivity to 

be established along the route. 


Pending Allocate Subnode Network 
Addresses: A node, such as a local 
or switched physical unit, is being 
connected and the Request Net- 
work Address Assignment request 
has been sent to the appropriate 

PU services. However, the associ- 
ated response was not received. 


Pending Connect Out Response: A 
node, such as a local or switched 
physical unit, is being connected 
and the Connect Out request has 
been sent to the appropriate PU 
services, but the associated response 
was not received. 


Pending Contact (1) Response: A 
node, such as a link station is being 
activated, and the first Contact re- 
quest was sent to the appropriate 
PU services, but the associated re- 
sponse was not received. 


Pending Contact (2) Response: A 
node, such as a PU or link station, 
is being activated, and the Contact 
request (second attempt for link 
station) has been sent to the appro- 
priate PU services, but the associ- 
ated response has not been 
received. 





Abbre- 
viation 
(Hex 

Value) 


PCTD1 
(041F) 


PCTD2 
(0424) 


Category 


Long 
Transient/ 
Suspended 


Long 
Transient/ 
Suspended 


Resource Status Codes 


Resource Status 


Pending Contacted (1) Request: If 
the resource is a link station it Is 
being activated, and a positive 
Contact response was received but 
the associated Contacted request 
was not received. An NCP will also 
be found in this state (in this case 

a suspended state) during activation 
while waiting for an adjacent link 
station to be activated. 


Pending Contacted (2) Request: If 
the node is a link station or peri- 
pheral PU, it is being activated and 
a Contact request was sent and the 
response received, but the associ- 
ated Contacted request has not 
been received. An NCP will also be 
found in this state (it is a suspended 
state in this case) during activation 
while waiting for an adjacent link 
station connected to it to be acti- 
vated. The difference between 
PCTD2 and PCTD1 is that an NCP 
in the PCTD1 state may be loaded 
if a Contacted request is received 
for an adjacent link station indica- 
ting that the communication con- 
troller needs to be loaded, whereas 
in the PCTD2 state, both the 
adjacent link station and the NCP 
would be deactivated. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PDACL 
(010F) 


PDACP 
(0110) 


PDANC 
(0442) 


PDANS 
(0104) 


PDELR 
(010E) 
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Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Resource Status 


Pending DACTLU Response: A 
node, such as an application pro- 
gram or a logical unit, is being dis- 
connected or deactivated. The 
DACTLU request has been sent, 
but the associated response has not 
been received. 


Pending DACTPU Response: A 
node, such as a communication 
controller or physical unit, is being 
disconnected or deactivated. The 
DACTPU request has been sent, 
but the associated response has 
not been received. 


Pending DACTPU ANSC: A. 


DACTPU has been sent to the re- 
source but the associated response 


has not been received. The re- 
source was being activated when an 
Auto Network Shutdown Complete 
(ANSC) RU was received. This re- 
quest causes the SSCP to reset the 
SSCP-PU session and then resume 
the activation procedure. 


Pending Inactivate ANS Processing: 
The Abandon Connect In request 
unit has been sent for a node such 
as a switched link. 


Pending Delete Network Resource 
Response: A node, such as an ap- 
plication program, is being discon- 
nected. The Delete Network Re- 
source request has been sent to the 
appropriate PU services, but the asso- 
ciated response has not been received. 





Abbre- 
viation 
(Hex 

Value) 


PDISC 
(010D) 


PDLNK 
(0112) 


PDLUC 
(011D) 


PDPAT1 
(0443) 


Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Resource Status Codes 


Resource Status 


Pending Discontact Response: A 
node, such as a link station or 
physical unit, is being deactivated 
or disconnected. The Discontact 
request has been sent to the appro- 
priate PU services, but the associ- 
ated response has not been 
received. 


Pending DACTLINK Response: A 
line or local device is being deacti- 
vated, and the DACTLINK request 
has been sent to the appropriate PU 
services, but the associated response 
has not been received. 


Pending Deactivate LU Cleanup: 
An active LU is undergoing error 
recovery processing and a DACTLU 
request has been sent, but the asso- 
ciated response has not been 
received. 


Pending DACTPU (ACT1): A 
DACTPU has been sent to the re- 
source but the associated response 
has not been received. 


The NCP was being activated and 
was found already loaded. This 
state is exited when the DACTPU 
response is received and processing 
will continue from the beginning. 
Another attempt to load will 

be allowed. 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category 


PDPA2 Short 
(0440) Transient 


PF DCP Short 
(0440) Transient 


PFDLU _ Short 
(0120) Transient 


PFDMP Long 
(0119) Transient 
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Resource Status 


Pending DACTPU (ACT2): A 
DACTPU has been sent to the 
resource but the associated re- 
sponse has not been received. 


If the resource is an NCP, it was 
being activated and a load was 
performed. Once the DACTPU 
response is received, the activation 
of the NCP will proceed. If the 
resource is a BSC 3270 PU, a 
General Poll Failure occurred and 
the DACTPU was sent to clean up 
internal control blocks. When the 
response is received, an ACTPU 
will be sent. 


Pending Force DACTPU Response: 
A DACTPU has been sent as a re- 
sult of a force reactivate or force 
deactivate command against a node, 
such as a communication control- 
ler. The response has not been 
received. 


Pending Force DACTLU Response: 
A DACTLU has sent as a result of a 
force deactivate command for the 
LU, but the response has not yet 
been received. 


Pending Dump Response: DUMP is 
being performed of an NCP over a 
link station and has not yet com- 
pleted processing. 


ae 


See 





Abbre- 


> viation 
7 (Hex 


Value) 


PFDSC 
} (042C) 


PFNNA 
(011C) 


PFSNA 
(010C) 


-— PHLAC 
) (040A) 


Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Suspended 


Resource Status Codes 


Resource Status 


Pending Force Discontact Re- 
sponse: A PU is being force deacti- 
vated or force reactivated and the 
Discontact request has been sent to 
the appropriate PU services, but 
the associated response has not 
been received. 


Pending Free Node Network Ad- 
dress: A node, such as a dynami- 
cally added PU or LU is being de- 
activated. The Free Network Aa- 
dress request has been sent to the 
appropriate PU services, but the 
associated response has not been 
received. 


Pending Free Subnode Network 
Addresses: A node, such as a Jocal 
or switched PU, is being discon- 
nected. The Free Network Address 
request has been sent to the appro- 
priate PU services, but the associa- 
ted response has not been received. 


Pending Higher-Level Activation: 
A node is awaiting activation of 

its higher-level node. For example, 
a local PU or LU is being activated, 
and the request to activate the 
associated channel, (that is, the 
associated PUB or UCB) has not 
completed. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PHLIN 
(0102) 


PINAC 
(0100) 


PLOAD 
(040E) 


PLSTC 
(043F) 
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Category 


Suspended 


Long 
Transient 


Long 
Transient 


Suspended 


Resource Status 


Pending Higher-Level Deactivation: 
A node is inactive and its higher- 
level node is being deactivated. For 
example, a local PU is inactive and 
the associated channel PUB or UCB 
is being deallocated. 


Pending Inactive: CDRM is being 
deactivated. This is along transient 
state because all cross-domain ses- 
sions involving the CDRM must be 
terminated before the CDRM is 
deactivated. 


Pending Load: An NCP is being 
activated and a loading operation 


has begun, or a peripheral PU, 


such as an 8775, being activated has 
requested a load and the SSCP sent 
the load request to an application 
program defined in the CNM 
routing tables. A response to the 
load request has not been received. 


Pending Load Station Conditional: 
Activation processing for an NCP is 
waiting for the link station over 
which the NCP will be loaded to 
become available. When the link 
station is available, ACF/VTAM 
will perform a conditional load if 
the link station is channel-attached, 
or otherwise an unconditional load. 





: Abbre- 
y viation 
~~ (Hex 

Value) 


ae PLSTU 
) (040D) 





PMALD 
(0446) 


* PMATM 
(0447) 





PNAUV 
(0404) 


<. ) PNFY1 
(0113) 


Category 


Suspended 


Long 
Transient 


Long 
Transient 


Short 


Transient 


Long 
Transient 


Resource Status Codes 


Resource Status 


Pending Load Station Uncondi- 
tional: Activation processing for 
an NCP is waiting for the link sta- 
tion over which the NCP will be 
loaded to become available. When 
the link station is capable of being 
used for loading, a load of the NCP 
will be done. 


Pending Migration ACTPU Load/ 
Dump Procedure: For an NCP 
session on a migration route, a 
session recovery loop has been sus- 
pended due to an ongoing load or 
dump operation. 


Pending Migration ACTPU Timer: 
An NCP, attempting session recov- 
ery on a migration route, is waiting 
for expiration of a time interval 
before retrying session activation. 


Pending Set LU Control Vector 
Response: A node, such as a 
switched or dynamically added 
logical unit, is being connected and 
the Set Control Vector request with 
the LU Control Vector has been 
sent to the appropriate PU services, 
but the associated response has not 
been received. 


Pending Notify(1) Request: A 
node, such as an LU, is being de- 
activated or disconnected. The re- 
quest to terminate user sessions has 
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Resource Status Codes 


Abbre- 

viation 

(Hex 

Value) Category 


PNFY2 Long 
(0108) Transient 


PNFY3 Long 
(0105) Transient 


POAS1 Long 
(0437) Transient 
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Resource Status 


been scheduled, but the Notify 
request indicating that the user 
sessions have ended has not yet 
been received. 


Pending Notify(2) Request: A 
node, such as a logical unit, is about 
to become connectable and the re- 
quest to terminate any queued user 
sessions has been scheduled. How- 
ever, the Notify request indicating 


that the user sessions have ended 


has not yet been received. 


Pending Notify(3) Request: A 
node is about to become inactive 
and the request to terminate 
queued user sessions has been 
scheduled. However, the Notify 
request indicating that the user 
sessions have ended has not yet 
been received. 


Pending Operator Query 
(AUTOSYN1) Response: A com- 
munication controller is being 
activated and message !ST183A or 
5B83A, which asks if the commu- 
nication controller should be re- 
loaded or resynchronized, has been 
issued. The message was sent after 
the communication controller was 
contacted but before an SSCP-PU 
session was established. The reply 
has not been received. 


Se 


ao 


> a: 











Abbre- 
viation 
(Hex 

Value) 


POAS2 
(0438) 


PREQC 
(0402) 


PRMPO 
(0103) 


PRSET 
(0101) 


PSARV 
(041B) 


Category 


Long 
Transient 


Long 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Resource Status Codes 


Resource Status 


Pending Operator Query 
(AUTOSYN2) Response: A com- 
munication controller is being 
activated and message IST183A or 
5B83A, which asks if the commu- 
nication controller should be re- 
loaded or resynchronized, has been 
issued. The message was sent after 
an SSCP-PU session was established 
with the communication controller. 
The reply has not been received. 


Pending Request Contact Request: 
A node, such as a local or switched 
physical unit, is being connected and 
the Connect Out response has been 
received, but the Request Contact 
request has not been received. 


Pending RMPO Response: A link 
station is being deactivated and the 
NCP attached to it has to be 
powered off. A Remote Power Off 
request has been sent and the 
response has not been received. 


Pending Reset: The resource is 
inactive, but the network name is 
still known to ACF/VTAM. 


Pending Set Subarea Routing Con- 
trol Vector Response: A node, such 
as alink station, is being activated 
and the Set Control Vector request 
containing a Subarea Routing Con- 
trol Vector has been sent to the appro- 
priate PU services, but the asso- 
ciated response has not been received. 
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Resource Status Codes 


Abbre- 
viated 
(Hex 
Value) 


PSDT 
(0429) 


PSNCP 
(0414) 


PSSSV 
(0406) 


PSTD 
(042B) 
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Category 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Short 
Transient 


Resource Status 


Pending Start Data Traffic (SDT) 
Response: A node, such as a com- 
munication controller is being 
activated, and the Start Data Traf- 
fic request was sent, but the associ- 
ated response was not received. 


Pending Switch to NCP Response: 
A PEP link is being activated, and 
the Switch to NCP request was 
sent, but the response has not been 
received. 


Pending Set SDLC Secondary 
Station (SSS) Control Vector 
Response: A switched physical 
unit is being connected, or a DR 
added PU is being activated, and 
the Set Contro! Vector Request 
containing an SSS control vector 
has been sent to the appropriate 
PU services, but the associated 
response has not been received. 


Pending Set Time and Date 
Response: A communication con- 
troller is being activated, and the 
Set Control Vector request con- 
taining a Set Time and Date Con- 
trol Vector was sent, but the 
associated response was not re- 
ceived. 


Abbre- 
viation 
_J (Hex 

Value) 


PSUBR 
: ) (0504) 


PSUB1 
(0115) 


__ PSUB2 
) (010A) 


Category 


Suspended 


Suspended 


Suspended 


Resource Status Codes 


Resource Status 


Pending Subnode Release: An 
acquired communication control- 
ler that was activated before it 
was acquired is being released; 
that is, a request to release the 
subnodes in the acquired portion 
of the communication controller 
is in progress. 


Pending Subnode Deactivate (1): 
A node supporting subnodes, for 
example, an application program 
segment, communication con- 
troller, link, or PU is being deacti- 
vated or disconnected and is wait- 
ing for its subnodes to complete 
deactivation processing before 
proceeding with its own deactiva- 
tion. (The differences between 
PSUB1, PSUB2, and PSUB3 vary 
for the node type. The different 
states are used to determine the 
next step to be taken in deacti- 
vating this node once its subnodes 
complete processing.) 


Pending Subnode Deactivate (2): 
A node supporting subnodes, for 
example, an application program 
segment, communication control- 
ler, link, or PU is being deactivated 
or disconnected and is waiting for 
its subnodes to complete deactiva- 
tion processing before proceeding 
with its own deactivation. (The dif- 
ferences between PSUB1, PSUB2, 
and PSUB3 vary for the node type. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


PSUB3 
(0107) 


PSWEP 
(0111) 


PTRM1 
(0114) 
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Category 


Suspended 


Short 
Transient 


Short 
Transient 


Resource Status 


The different states are used to 
determine the next step to be taken 
in deactivating this node once its 
subnodes complete processing.) 


Pending Subnode Deactivate (3): A 
node supporting subnodes, for ex- 
ample, an application program seg- 
ment, communication controller, 
link, or PU is being deactivated or 
disconnected and is waiting for its 
subnodes to complete deactivation 
processing before proceeding with 
its own deactivation. (The differ- 
ences between PSUB1, PSUB2, and 
PSUB3 vary for the node type. The 
different states are used to deter- 
mine the next step to be taken in 
deactivating this node once its 
subnodes complete processing.) 


Pending Switch to EP Response: A 
PEP link has been deactivated. The 
Switch to EP Mode request has 
been sent to the appropriate PU 
services, but the associated response 
has not been received. 


Pending Terminate(1) Response: A 
node, such as an LU, is being deac- 
tivated or disconnected. The 
request to terminate user sessions 
has been scheduled, but the associ- 
ated response has not yet been 
received. 


\ ay 


Abbre- 

“yp viation 
y (Hex 

- Value) 


PTRM2 
(0109) 


§ PTRM3 
(0106) 





PVYLM 
(0435) 


PO95A 
} (0118) 


P284A 
(0408) 


Category 


Short 
Transient 


Short 
Transient 


Long 
Transient 


Long 
Transient 


Long 
Transient 


Resource Status Codes 


Resource Status 


Pending Terminate(2): A node, 
such as an LU, is about to be- 
come connectable and the request 
to terminate queued user sessions 
has been scheduled. However the 
associated response has not yet 
been received. 


Pending Terminate(3) Response: 
An LU is about to become inactive 
and the request to terminate 
queued user sessions has been 
scheduled, but the associated 
response has not yet been received. 


Pending Operator Query (VFYLM) 
Response: The resource is being 
activated and the ACF/VTAM 
operator message IST361A or 
5D61A has been issued, but the 
reply has not yet been received. 
Message IST361A or 5D61A asked 
the operator if he wanted to load 
the NCP or terminate the NCP’s 
activation. 


Pending Operator Query Response: 
An error recovery procedure (ERP) 
issued message ISTO95A or 5A95A, 
asking whether an ERP DUMP is 
desired. The reply has not been 
received. 


Pending Operator Query Response: 
Acommunication controller is being 
recovered and message IST284A or 
5C84A, asking whether the com- 
munication controller should be 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


RACTH 
(0301) 


RACTN 
(0300) 


RADDF 


(0433) 


RDIAL 


(0201) 


RELSD 
(0002) 


Category 


(See Note) 


(See Note) 


Internal 


(See Note) 


Final 


Resource Status 


reloaded, has been issued. The 
reply has not been received. 


Reactivate at Higher Level: The 
resource is being deactivated and, 
once inactive, will wait for its reac- 
tivation to be driven by a higher- 
level node.? 


Reactivate at this Level: The 
resource is being deactivated and 
will then be reactivated at this 
level.? 


RDTADD Failed: A node was 
being activated and the request to 
add the associated network address 
to the ACF/VTAM’s network 
address table has failed. A request 


-to deactivate the resource has been 


scheduled. 


Redial: A switched PU is being 
disconnected and an attempt to 
redial the PU will be made once 
disconnection is complete.? 


Released: A physical unit has been 
released or it exists in the unowned 
Portion of an activated-before- 
acquired 3705 and has not yet 
been acquired. 


1 This is a desired state only. 
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MO 


Abbre- 

viation 

(Hex 

Value) Category 


RESET Final 
(0000) 


RINAC Long 
(0600) Transient 


RRLSD Long 
(0601) Transient 


183 AF Internal 
(0418) 


Resource Status Codes 


Resource Status 


Reset: As acurrent state, this 
means that the RDT segment has 
been built but has not been 
processed by the SSCP. This value 
for an LU can also mean that a 
VARY NET,REL command for 
the associated PU has been com- 
pleted. 


As the NCP’s load dump procedure 
status, this state means that no load 
or dump procedure is in progress. 


Routable, Inactive: A MODIFY 
LL2 command is being processed 
for an inactive DR-added PU. 
When the LL2 test is terminated 
the PU will be returned to the in- 
active state. 


Routable, Release: A MODIFY 
LL2 command is being processed 
for a released DR-added PU. When 
the LL2 test is terminated, the PU 
will be returned to the released 
state. 


Operator Query (AUTOSY NCH) 
Failed: A request to issue message 
IST183A or 5B83A was scheduled, 
but the message could not be issued. 
Processing continues as if the reply 
was negative. 
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Resource Status Codes 


Abbre- 
viation 
(Hex 

Value) 


284 AF 
(0407) 


TRACT? 
(03) 


TRPAR? 
(02) 


TRPDR? 
(01) 


TRRES!} 
(00) 


Category 


Internal 


Final 


Short 
Transient 


Short 
Transient 


Final 


Resource Status 


- Operator Query Failed: A request 


to issue. message 5C84A has been 
scheduled, but the message could 
not be issued. Processing continues 
as if the reply was negative. 


Trace Active: The trace indicated 
is active for this line. 


Pending Active Trace Response: 
The trace is being activated and the 
ACTTRACE request has been sent 
but the associated response has not 
been received. 


Pending DACTTRACE: The trace 
is being deactivated and a 
DACTTRACE request has been 
sent, but the associated response 
has not been received. 


Trace Reset: The trace indicated 
is inactive for this line. 


1 This value may appear ina 1-byte field containing the 
line trace status. 
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System Completion Codes (OS/VS) 


This section contains only the OS/VS system completion 
codes related to ACF/VTAM. The remainder of the system 
completion codes are listed in the appropriate OS/VS 
Message Library: System Codes. 


System completion codes indicate that the control program 
has determined that a task cannot continue processing and 
expect valid results. For example, an error may have 
occurred during the execution of a user's application program 
and was detected by ACF/VTAM. In such a case, processing 
of the task is terminated, and a completion code is supplied 
which indicates the reason for the termination. When appro- 
priate to the error, the explanation of the completion code 
suggests a programmer response intended to correct the 
reason for the abnormal termination. If the error cannot be 
corrected by correcting program code, the problem deter- 
mination action should be followed. The problem deter- 
mination table for the system completion codes is at the end 
of this section. 


OA7 


Explanation: During ACF/VTAM HALT NET, 
CANCEL processing, ACF/VTAM found that a 
TPEND exit routine did not exist or could not be 
scheduled for each access method control block 
(ACB) opened by the user’s application program. 


System Action: The user’s task is abnormally 
terminated. 


Programmer Response: None. 
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System Completion Codes 


0A8 


OA9 
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Explanation: ACF/VTAM detected an error that 
occurred during the execution of a user’s application 
program, The contents of the low-order 2 bytes of 
register 15 indicates the cause of the error: 


Register 15 

Contents in 

Hexadecimal: Explanation: 

2101 An ACF/VTAM validity check of 
the user’s request parameter list 
(RPL) failed because the RPL does 
not have the same protection key 
as the application programs’s TCB. 

7001 The user’s request parameter list 


(RPL) or event control block 
(ECB) is invalid. 


System Action: The task abnormally terminates. 


Programmer Response: Probable user error. 
Verify that the RPL and ECB pointers are correct 
and execute the job step again. 


Explanation: An error occurred during the execu- 
tion of an ACF/VTAM module. The contents of 
the low-order 2 bytes of register 15 indicate the 
cause of the error. 


Register 15 

Contents in 

Hexadecimal: Explanation: 

0000 An ACF/VTAM HALT NET, 


CANCEL command has been 
processed successfully. 


3141 An ACF/VTAM destination vector 
table (DVT) entry is invalid for 
the defined attachment. 


Ae 





Register 15 
Contents in 
Hexadecimal: 


7001 


7002 


7003 


7004 


7005 


7071 


7141 


10F 1 


System Completion Codes 


Explanation: 


An ACF/VTAM application pro- 
gram has specified an invalid 
RPL or ECB. 


An ACF/VTAM request for 
storage failed. 


An ACF/VTAM request to re- 
iease storage failed because the 
storage had already been released. 


ACF/VTAM could not obtain a 
local storage lock. 


ACF/VTAM was unable to re- 
store its registers after a user 
exit routine returned to 
ACF/VTAM. 


A RELSTORE was issued for 
a previously freed buffer. 


Control cannot be passed to the 
proper ACF/VTAM module. 
Either an ACF/VTAM desti- 
nation vector table (DVT) entry 
is invalid for the defined attach- 
ment or ACF/VTAM storage has 
been altered. 


The ABEND was issued by the 
ACF/VTAM STAE retry routine 
so that the user recovery routine 
(STAE exit routine) could get 
control. 


System Action: The task that initiated the ACF/ 
VTAM request abnormally terminates. 


Programmer Response: None. 
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System Completion Codes 


OAA 


OAB 


50 


Explanation: An abend condition occurred during 
execution of ACF/VTAM. ACF/VTAM’s func- 
tional recovery routines (F RRs) were unable to 
associate the failure with any particular TCB in 

the address space. 


System Action: All the tasks in the address 
space are abnormally terminated. 


Programmer Response: None. 


Explanation: An error occurred while TSO/ 
VTAM was in operation and a VTIOC module was 
executing an ACF/VTAM macro instruction. The 
contents of the 2 low-order bytes of register 15 
indicate the cause of the error: 


Register 15 
Contents in 
Hexadecimal: Explanation: 


0101 The terminal input manager for 
IBM 3767, IBM 3770, and NTO 
terminals (IKTIMLU1) encoun- 
tered an unrecoverable error while 
executing an ACF/VTAM macro 
instruction that uses a request 
parameter list (RPL). 


0102 The terminal output manager for 
IBM 3767, IBM 3770, and NTO 
terminals (IKTOMLU1) encoun- 
tered an unrecoverable error while 
executing an ACF/VTAM marco 
instruction that uses an RPL. 


0103 The terminal input manager for 
IBM 3270 SNA terminals 
(IK TIMLUO or IKTIMLU2) en- 
countered an unrecoverable error 
while executing an ACF/VTAM 
macro instruction that uses an 
RPL. 


ATEN, 





Register 15 
) Contents in 


Hexadecimal: 
0104 
0105 
0201 
0202 
} 
) 
ial 0203 


System Completion Codes 


Explanation: 


The terminal output manager for 
IBM 3270 SNA terminals 
(IKTOMLUO or IKTOMLU2) en- 
countered an unrecoverable error 
while executing an ACF/VTAM 
macro instruction that uses an 
RPL. 


The VTIOC LOSTERM exit rou- 
tine encountered an error during 
execution of a BIND or UNBIND 
command that used an RPL. 


The error occurred during initial- 
ization of a TSO/VTAM user ad- 
dress space. An application 
program ID problem was encoun- 
tered while executing ACF/VTAM 
OPEN macro instruction. 


The error occurred during execu- 
tion of an ACF/VTAM OPEN mac- 
ro instruction. The ERROR field 
of the ACB indicates the problem. 
The values that can be set in the 
ERROR field are shown in Part 3, 
“Programming,” in the section 
titled, “ACB ERROR Field 
Values.”’ 


The error occurred during execu- 
tion of an ACF/VTAM CLOSE 
macro instruction. The code in the 
ERROR field of the ACB is hex 42, 
indicating that the ACB has been 
closed but an ACF/VTAM error 
has prevented the successful dis- 
connection of one or more TSO 
terminals. 
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System Completion Codes 


OAC 


52 


System Action: The terminal session in which the 
error occurred terminates. 


Programmer Response: None. 


Explanation: The terminal control address space 
(TCAS) was unable to continue its normal pro- 
cessing due to an error. The 2 low-order bytes 
of register 15 and TCAS work area (TWAR) field 
TWARSON both contain the reason code that 
indicates the cause of the error: 


Reason 

Code in 

Hexadecimal: Explanation: 

00 STOP command was entered. 

04 Invalid START command was 
issued. 

10 The TCAS main task was unable 


to attach the ACF/VTAM inter- 
face subtask. 


14 The TCAS main task was unable 
to attach the user interface sub- 
task. 

18 The TCAS main task was unable 


to attach the console communi- 
cation subtask. 


1C TCAS was unable to obtain stor- 
age for the TCAS table (TCAST) 
in the common service area 
(CSA). 


20 The TCAS main task abnormally 
terminated and was unable to 
recover. 


— 








OAD 


Reason 
Code in 
Hexadecimal: 


30 


34 


38 


System Action: 


System Completion Codes 


Explanation: 


The ACF/VTAM interface subtask 
abnormally terminated and was 
unable to recover. 


The user interface subtask abnor- 
mally terminated and was unable 
to recover. 


The console communication sub- 
task abnormally terminated and 
was unable to recover. 


TCAS abnormally terminates. 


Operator Response: Reply ‘‘DUMP” to TCAS 
termination message IKT0O12D to obtain a dump. 


Explanation: An error occurred while TSO/VTAM 
was in operation and VTIOC’s queue manager was 
executing a GETCELL or FREECELL macro 
instruction. The contents of the 2 low-order bytes 
of register 15 indicate the cause of the error: 


Register 15 
Contents in 
Hexadecimal: 


0108 


010C 


0110 


020C 


Explanation: 


The cell address supplied to the 
FREECELL macro instruction 
was invalid. 


No cell pool existed for the 
FREECELL request. 


An invalid cell pool 1D was 
specified for the FREECELL 
request. 


No cell pool existed for the 
GETCELL request. 
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System Completion Codes 


Register 15 
Contents in 
Hexadecimal: Explanation: 


0210 An invalid cell pool 1D was speci- 
fied for the GETCELL request. 


System Action: The queue manager abnormally 
terminates, and the terminal session in which the 
error occurred terminates. 


Programmer Response: None. 
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Cancel and Function Codes (VSE) 


J When an ACF/VTAM routine issues CANCEL, register 15 
and the TIBCNCL field in the task information block (TIB) 
contains codes that aid in determining the reason for the can- 
celation. A cancel code is set in the TIB and a function code 

~~, is set in register 15. The cancel code also appears at the end 

) of message 5J97I1: 


5J971 VTAM CANCELLED FOR INVALID 
CONDITION cancel code 


, Note: This message is also issued without a cancel code 
im under some conditions. See ACF/VTAM Messages and 
' Codes for more information. 





Cancel Codes 


Cancel codes are set in the VSE TIB cancel fields (hex 1A). 
This field is found at displacement hex 01 in the PIB. For 
information about the relationship between the TIB and 
ACF/VTAM control blocks, see ACF/VTAM Diagnosis 
Reference. Possible cancel codes are: 


Hex 40 The application program task was canceled 
because ACF/VTAM terminated. 


Hex 41 ACF/VTAM terminated in this task with the 
} function code indicated. 


If the hex 40 is set, message 5J971 is issued: 


5J951 taskname CANCELLED DUE TO 
TERMINATION OF VTAM 


) If hex 41 is set, message 5J97I is issued: 


5J971 VTAM CANCELLED FOR INVALID 
CONDITION function code 


55 


Function Codes 


The 2 low-order bytes of register 15 are set with flags and a 
function code. The flags occupy the first 4 bits, and function 
code occupies the remaining 12 bits. The function codes are 


listed below: 

Function Issuing 
Code (hex) Module 
7001 ISTAICPT 
7002 ISTAICPT 
7003 ISTAICPT 
7071 ISTORCRT 
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Reason 


The address of an appli- 
cation program’s RPL or 
ECB is invalid. 


REQSTORE return code is 
greater than 8. The request 
is invalid; the user-defined 
header size exceeds the buf- 
fer size, or the number of 
buffers requested is larger 
than the specified pool. 


REOSTORE return code is 
greater than 8. 


RELSTORE was issued for 
an area of storage that was 
not originally obtained by 

REQSTORE. 


Coding Conventions 


PART 2. INSTALLATION 
y Coding Conventions 
Conventions used to explain the syntax of macro instruc- 


tions and definition statements, and the rules used to code 
) them are summarized here as assembler language rules. 








Name Operation Operands 
Symbolic Macro instruction Required and optional 
name or statement operands 








The Name field symbolically identifies the macro instruc- 
tion, definition statement, or minor node. If a symbolic 
name is specified in the field, it must contain 1 to 8 char- 
acters in the following format: 





first character — alphabetic (A-Z) or the national 
characters @, #, or $ 


second through — alphameric (A-Z or 0-9) or the national 
eighth character characters @, #, or $ 


The name must begin in the first position of the macro 
instruction or statement and. must be followed by one or 
) more blanks. 


The Operation field identifies the macro instruction or state- 
ment. It must be preceded and followed by one or more blanks. 


_ The Operands field contains operands coded in any order 

) and separated by commas. The Operands field ends with 

*” one or more blanks placed after the last operand. In most 
macro instructions or statements, keyword operands are used 
in the Operands field. Keyword operands are followed by an 
equal sign (=) and the keyword value. The keyword value 

y can be a single value or a list of values. If it is a list of values, 

) the values must be separated by commas and the list must be 
enclosed in parentheses. 


Coding Conventions 


Comments can be written after the Operands field, but they = 
must be separated from the last operand of the Operands field -_ 
by one or more blanks. An entire card can be used foracom- ~~ 
ment by placing an asterisk in the first column of the card. A 
macro instruction that has no operands cannot have comments 

on the same card as the operation code. 


ACF/VTAM definition statements and NCP generation macro 


instructions are coded in columns 1 through 71 of a card. A Se 
statement or macro instruction that exceeds 71 columns can 

be continued on one or more additional cards by placing a 

nonblank character in column 72 to indicate continuation. 


The operands can be interrupted either at column 71 or after | 

any comma that separates operands. The continued portion — 
- must begin in column 16 of the following card. Comments 

can appear on every card of a continued statement. Columns 

73 through 80 can be used to code identification characters, 

statement sequence characters, or both. 








Restrictions on Use of Assembler Features 


The NCP generation macro instructions and the ACF/VTAM 
definition statements are coded in standard operating system . 
macro instruction format, as described above, with the 

following restrictions: 


Assembler program control instructions (such as ICTL, 
ISEQ) cannot be used in major node definition decks. 


Assembler listing control statements (such as PRINT, 
SPACE, EJECT) can be used in the NCP generation deck 
but must not be used in definition decks for the other 
types of major nodes. 


Some assembler features must not be used in a major node See 
definition deck: 


User assembler macro instructions that generate NCP 
macro instructions are not permitted. 


vanad 


| Names generated by global variables (for example, 
&SYSNDX or &SYSECT) cannot be used. 


Variable substitution at assembly time is not permitted. 
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Coding Conventions 


References to assembler attributes (length, type, etc.) 
are not permitted. 


Use of literals is not permitted. 


Quoted strings cannot be used to make names out of key- 
words. For example, AUTH="PASS” is treated just like 
AUTH=PASS. 


Comments, statements, or remarks can be used in decks for 
all types of major nodes. 


Errors made in the major node definition decks filed in the 
ACF/VTAM definition library result in messages to the 
system operator’s console during ACF/VTAM initialization 
or VARY ACT command processing. 


Missing continuation characters can cause the NCP (during 
NCP generation) to assume values that are not physically 


correct (for example, half-dupliex lines instead of full-duplex 


lines). 
Macro Instructions and Definition Statements 


Conventions used to illustrate the format and coding of mac- 
ro instructions and definition statements are as follows: 


Capital Letters: Capital letters represent values that are 
coded directly, without change. Brackets [], “or” bar |, 
underlines, and superscripts are never coded. 


Lowercase Letters: Lowercase letters represent operands for 
which a value or name must be supplied if the operand is 
coded. 


Brackets []: Brackets enclose operands or symbols that are 
either optional or conditional. Conversely, the lack of brack- 
ets indicates that an item or group of items must be coded. 


An optional operand is one that can be coded or omitted in- 
dependently of other operands that are coded or omitted. 
Depending on the operand, omitting it might cause the cor- 
responding feature or function to be omitted or included, 

Or Omitting it can cause a specific value (the default value) to 
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Coding Conventions 


be assigned. When the syntax of a macro instruction or state- 
ment is shown in this book, any operands that are always re- 
quired appear first, followed by the optional or conditional 
operands in alphabetical order. 


Vertical “or” Bar (|): A vertical bar between operands indi- 
cates that one operand must be coded from among the values 
separated by the "'or”’ bar. 


Parentheses, Equal Sign, and Commas: Parentheses, equal 
signs, and commas are coded as shown. 


Underlined Values: An underlined value represents the value 
that ACF/VTAM or the NCP uses if the operand is omitted 
(the default value). 


Braces { : Braces indicate mutually exclusive operands. 
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Defining: Application Program @ Local Non-SNA 


Defining the Network 
Application Program Major Nodes 


For an application program major node, code one VBUILD 
statement and then one APPL statement for each application 
program. 


[name] VBUILD TYPE=APPL 


name APPL [,ACBNAME=acbname] 

[, AUTH=(|ACQ|NOACO] 
[,CNMINOCNM] 
[,PASS|INOPASS] 
[,PPO|SPO|NOPO] 
[,.TSO|INOTSO]? 
[, VPACEINVPACE] )] 

[, AUTHEXIT=YES|NO] ? 

[, DLOGMOD=default logon mode entry 

name] 





[,EAS=n|404] 
[,ENCR=SEL|REQD|OPT|NONE] ? 
[,MAXPVT=n|Q] 4 
[,MODETAB=logon mode table name] 
[,PARSESS=YES|NO] 
[,PRTCT=password ] 
[,SONSCIP=YES|NO] 
[,SPAN=name] ° 
[,SRBEXIT=YES|NO]! 

[, VPACING=n|0] 

[, VTAMFRR=YES|NO]! 


Local Non-SNA Major Nodes 


Code one LBUILD statement for each set (major node) 
of channel-attached non-SNA terminals. 


[name] LBUILD [,CONFGDS=ddname] 
[,CONFGPW=password] 





1 Applies to MVS only. 

2 Applies to OS/VS1 only. 

3 Applies to the Encrypt/Decrypt Feature only. 
* Applies to OS/VS only. 

> Applies to NCCF only. 
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Defining: Local Non-SNA e@ Local SNA 


Code one LOCAL statement for each channel-attached non- 
SNA terminal (minor node) in the major node. 


name LOCAL CUADDR=address 
[,TERM=3277|3284|3286] 
[,.DLOGMOD=default logon mode entry 
name] 

[,.FEATUR2=({[EDATSINOEDATS] 
[MODEL1| MODEL2]) 

[ ISTATUS=ACTIVEIINACTIVE] 

[, LOGAPPL=application program name] 

[,_OGTAB=interpret table name] 

[, MODETAB=logon mode table name] 

[,SPAN=name] ! 

[,USSTAB=USS definition table name] 


Local SNA Major Nodes 


Code one VBUILD statement for each set of channel- 
attached SNA devices. 


[name] VBUILD TYPE=LOCAL 
[,CONFGDS=ddname] 
[, CONFGPW=password] 
Code one PU statement for each physical unit in the local 
SNA major mode. 


name PU CUADDR=address 
[,DISCNT=([YES|NO] [,FINF] 
[, DLOGMOD=default logon mode entry name] ” 
[,.ENCR=REQD|SELIOPT|INONE] 273 
[L ISTATUS=ACTIVE|INACTIVE] 
[, LOGAPPL=application program name] ? 
[, LOGTAB=interpret table name] ” 
LMAXBFRU=number|1] 
[,MODETAB=logon mode table name] ? 
[,PACING=n|0/1] ? 
[,PUTYPE=2] 
[,SPAN=name] ! 
[,SSCPFM=FSS|USSSCS] ” 
[,USSTAB=USS definition table name] ? 
[, VPACING=n1011] 


1 Applies to NCCF only. 

2 If any of these operands are specified in both the PU and LU 
statements, the values used are those in the LU statement. 

3 Applies to OS/VS only. 
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Defining: Local SNA @ Switched 


Code one LU statement for each logical unit associated with 
a physical unit within a local SNA major node. 


} name LU LOCADDR=n 
A [, DLOGMOD=default logmode entry] ? 
[,.ENCR=REQD|SEL|OPT|NONE]?!3 
LISTATUS=ACTIVE|INACTIVE] 
[, LOGAPPL=application program name] ° 
) [, LOGTAB=interpret table name] 3 
[,MODETAB=logon mode table name] ? 
[,PACING=nj0|1] ? 
[,SPAN=name] ? “3 
[, SSCPFM=FSS|USSSCS] ° 
[, USSTAB=USS definition table name] * 
} [, VPACING=n|0/1] 3 





Switched Major Nodes 


Code one VBUILD statement for each switched major 
node. 


name VBUILD TYPE=SWNET 
[,MAXGRP=n] 
[,MAXNO=n] 
[,CONFGDS=ddname] 
[,CONFGPW=password] 


) 1 Applies to the Encrypt/Decrypt Feature only. 
2 Applies to NCCF only. 
3 If any of these operands are specified in both the PU and LU 
statements, the values used are those in the LU statement. 
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Defining: Switched 


Code one PU statement for each physical unit in the switched 
major node. a 


name PU ADDRe=station address 
,DBLK=identification block 
ADNUM=identification number 
[,BATCH=YESINO] io 
[,DISCNT=([YESINO] [,FINF])] 





[, DLOGMOD=default logmode entry name] hc 

[, ENCR=REDO|SEL|OPT|INONE] ° 

[, FEATUR2=(MODEL1|MODEL2,LOWERCSE| 
DUALCSE)]? 7 

[ IRETRY=YESINO] a 


LISTATUS=ACTIVE|INACTIVE] As 
[,_OGAPPL=application program name] 
[,LOGTAB=interpret table name] 

[ MAXDATA=SIZE(261|265] 4 

[ MAXOUT=n/1] 

[,MAXPATH=n|0] 

[,MODETAB=logon mode table name] ! 
[,PACING=n|0/1] ! 

[,PASSLIM=n(1] 

[ PUTYPE=n/2] % 
[ SPAN=name] ? 
[,SSCPFM=ESS|USSSCS|USSNTO]! 
[,TERM=terminal type] ! 

[, USSTAB=USS definition table name] ? yo 
[, VPACING=n|0/2] 


1 1f any of these operands are specified in both the PU and 
LU statements, the values used are those in the LU 


statement. = 
? Applies to NCCF only. a 
3 Applies to OS/VS only. ae 


* Default 261 applies to PU type 1 and default 265 applies 
to PU type 2. 
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Defining: Switched 


Code up to 256 PATH statements to define dial-out paths 
) for each physical unit. Each PATH statement must immedi- 

y ately follow the PU statement that defines the associated 
physical unit. 


[name] PATH DIALNO=telephone number 


- GID=n, 
) GRPNM=groupname, 
- LINEM=linename 
PID=n 


[,REDIAL=n/3] 
[,USE=YESINO] 





Code one LU statement for each logical unit associated 
with a physical unit within a switched major node. 


name LU LOCADDR=n 
[,BATCH=YES/NO]! 
[,DLOGMOD=default logmode entry] ? 
[,ENCR=REQD|SEL|OPT|NONE] ! 2 
[,FEATUR2=(operand,operand.. .)]? 
[, ISTATUS=ACTIVE|INACTIVE] 
[,LOGAPPL=application program name] ! 
[,LOGTAB=interpret table name]?! 
[,MODETAB=logon mode table name] ! 
[,PACING=n|011]}? 
[,SPAN=name] ° 
[,SSCPF M=FSS|USSSCS|USSNTO]? 
[, TERM=terminal type] ? 
{, USSTAB=USS definition table name] 
[,VPACING=n|0|1] 





11f any of these operands are specified in both the PU and 
LU statements, the values used are those in the LU 
statement. 

? Applies to the Encrypt/Decrypt Feature only. 

3 Applies to NCCF only. 
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Defining: NCP 


Network Control Program Major Nodes 


File one or more PCCU statements in front of the NCP 


generation deck. 


[symbol] PCCU 


INCPLUB=lubname! 

[, AUTODMP=YESINO] 

[, AUTOIPL=YES|NO] 

[ AUTOSYN=YESINO] 

[,BACKUP=YES|NO] ? 

[,CHANCON=COND|UNCOND] 

[,CONFGDS=ddname] 

[,.CONFGPW=password] 

[,CUADDR=channel device name] 

[,DUMPDS=dumpname] 

[, DUMPSTA=link station name] 

[INI TEST=YESINO] 

[,LOADSTA=link station name] 

[L.MAXDATAssize] 

[,OWNER=ownername] 

[,RNAME=link station name|(name, 
name, ...,name)] 

[, SUBAREA=n] 

[, VFY_LM=YES|NO] 





1 Applies to VSE only. 
2 Applies to the Multisystem Networking Facility only. 
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Defining: NCP 


- NCP generation operands that are used by ACF/VTAM 
3 are as follows: 





ANS 

| ANSWER 

) ATTN 

: AUTO 
AUTODL 
BATCH 
BHSET 
BNNSUP 
CALL 
CDATA 
CONV 
CUTYPE 
DEVICE 
DIAL 
DIALNO 
DIRECTN 

. DISCNT 

) DLOGMOD 


ENCR 


V = ACF/VTAM only; for a description, refer to ACF/ 
f VTAM Planning and Installation Reference. 
) N = ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. The 
Network Terminal Option Installation manual 
should be consulted for further discussion. 
- R = ACF/VTAM restriction; for a description, refer to 
) ACF/VTAM Planning and Installation Reference. 
<a The operand is described in ACF/NCP-SSP Instal- 
lation. 
* = Described in NCP Generation Manual (no special 
ACF/VTAM restrictions). 
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- Defining: NCP 


NCP generation operands used by ACF/VTAM (continued) 


ENDTRNS 

EXEC Z 
FEATUR2 ee 
GPOLL 

IDSEQ 

IRETRY 

ISTATUS e 
LINEADD 
LINEAUT 
LNCTL 
LOCADDR 
LOGAPPL 
LOGTAB 
MAXDATA 
MAXLU 
MAXOUT 
MODETAB 
OWNER 
PACING 
PASSLIM 
PAUSE 
POLIMIT 
POLL — 
POLLED 


St 


R 
* 


x* *D So oe kK KEK SK 
*D<<c +e KOK 


* 


D 
D 





V = ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. —_ 
N = ACF/VTAM only; for a description, refer to ACF/ 


VTAM Planning and Installation Reference. The 
Network Terminal Option Installation manual 
should be consulted for further discussion. 

R = ACF/VTAM restriction; for a description, refer to 7 
ACF/VTAM Planning and Installation Reference. 4 - 
The operand is described in ACF /NCP-SSP Instal- a, 


lation. 
* = Described in NCP Generation Manual (no special | 
ACF/VTAM restrictions). 
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Defining: NCP 
NCP generation operands used by ACF/VTAM (continued) 


PT3 EXEC 
PU 
PUTYPE 
SESSION 
SSCPFM 
SUBAREA 
(used by PU) 
TERM 
TGN 
TYPE 
USE 
USSTAB 
VIRTUAL 
~VPACING 
X21SW 





V =ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. 

N =ACF/VTAM only; for a description, refer to ACF/ 
VTAM Planning and Installation Reference. The 
Network Terminal Option Installation manual 
should be consulted for further discussion. 

R =ACF/VTAM restriction; for a description, refer to 
ACF/VTAM Planning and Installation Reference. 
The operand is described in ACF/NCP-SSP Instal- 
lation. 

* = Described in NCP Generation Manual (no special 
ACF/VTAM restrictions). 
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Defining: CDRM e CDRSC 
Cross-Domain Resource Manager (CDRM) Major Nodes 


Code a VBUILD statement for each set of CDRM definition 
statements. 


{name] VBUILD TYPE=CDRM 
[,CONFGDS=ddname] 
[, CONFGPW=password] 


Code one or more CDRM definition statements to define 
CDRM minor nodes. 


cdrmname CDRM SUBAREA=n 
[,CDRDYN=YES/NO] 
[,CDRSC=OPT|REQ] 
[,ELEMENT=ni1] 
[ ISTATUS=ACTIVE|INACTIVE] 
[, VPACING=n|0/63] 


Cross-Domain Resource (CDRSC) Major Nodes 


Code a VBUILD statement for each set of CDRSC definition 
statements. 


[name] VBUILD TYPE=CDRSC 
{[, CONFGDS=ddname] 
[,CONFGPW=password] 


Code one or more CDRSC definition statements to define 
CDRSC minor nodes. 


cdrscname CDRSC CDRM=cdrmname 
[L ISTATUS=ACTIVE|INACTIVE] 
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Defining: Cross-Domain Path 


Cross-Domain Path Tables 


y Code one or more PATH statements to define a path 
ies definition set to represent the routes ACF/VTAM takes to 
communicate with other subarea nodes. 


- symbol PATH DESTSA=nj(n1,n2,n3, ... ) 
) [,ERO=(adjsub, [tg#] )] 
[,ER1=(adjsub, [tg#] )] 


[,ER7=(adjsub, [tg#] )] 
[, VRO=er#] 
[,VR1=er#] 





{, VR7=er#] 
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TSO/VTAM Requirements 


An APPL definition statement defines an application 
program to ACF/VTAM. Because TCAS and each TSO user 
are ACF/VTAM application programs, APPL definition 
statements must be specified for them and put into 
SYS1.VTAMLST. 


Code the following APPL statements for TCAS: 


TSO APPL PRTCT=password’ ,AUTH= 
(NOACO,PASS,NVPACE,TSO, 
NOPO),EAS=1 


Code as many APPL statements, in the following format, as 
there will be users logged on to TSO/VTAWM at one time: 


TSOnnnn2 = APPL PRTCT=password! ,AUTH= 
(NOACQ,PASS,NVPACE,TSO, ~ 
NOPO),EAS=1 


Multiple-Domain Network 


TCAS and the terminals are defined with special statements. 


Code the following CORM statements in each domain? : 
name CDRM CDRDYN=YES,CDRSC=OPT,... 
name2 CDRM CDRDYN=YES,CDRSC=OPT,... 


1The same password must be specified for TCAS and each 
TSO/VTAM user. 

* A different application program name, in the form 
TSOnnnn, must be specified for each session. The suffix 
nnnn is a decimal number; the numbering must start with 
0001 and must be sequential. Note that NOACO and 
NOPO need not be coded; they are default values. 

3 This is to avoid defining both the SLUs that log on to 
TSO/VTAM as CDRSCs in the TSO/VTAM domain, and 
the TSO user application programs as CDRSCs in the 
SLU’s domain. This is controlled by the CORDYN and 
CDRSC operands. 
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TSO/VTAM Requirements 


Code the following APPL statement for TCAS in your 
domain: 


thistso! APPL ACBNAME=TSO, 
PRTCT=password, 
AUTH=(NOACO,PASS, 
NOVPACE,TSO,NOPO), 
EAS=1 


Code as many APPL statements in the following format as 
the maximum number of sessions that will be established 
with TSO/VTAM in your domain at one time: 


thistsonnnn!:?, APPL ACBNAME=TSOnnnn, 
PRTCT=password, 
AUTH=(NOACO,PASS, 
NVPACE,TSO,NOPO), 
EAS=1 


Code the following statement for each TCAS in another 
domain with which an LU in your domain will 
communicate: 


thattso? CDRSC CDRM=name of ACF/VTAM 
manager for thattso 


thistso is a unique prefix that must be included on all APPL 


statements for your domain. The name, thistso, must be 
unique in the network. The same prefix (that is, thistso) 
must be specified when coding APPL statements for each 
terminal logged on to the TSO/VTAM in this ACF/VTAM 
host concurrently. 

* The nnnn suffix is a decimal integer that must start with 
0001 and be sequential. The remaining operands are 
described above. 

3 thattso specifies the name of the TCAS APPL definition 
statement in the domain of the indicated CDRM that this 
CDRSC represents. 
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TSO/VTAM Requirements 


If dynamic cross-domain resource definition is not author- 
ized, code the following CDRSC statements in each domain 


that contains an SLU that can communicate with your 
domain: 


thattsonnnn'!?, CDRSC CDRM=name of ACF/VTAM 
manager for thattsonnnn 
application 


and code a CDRSC statement in the domain of TSO/VTAM 
for each cross-domain SLU that can log on to TSO/VTAM. 


1 thattso specifies the name of the TSO user APPL definition 
statement in the domain of the indicated CDRM that this 
CDRSC represents. 

2 The nnnn suffix is a decimal integer that must start with 
0001 and be sequential. The remaining operands are ~ 
described above. 
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TSO/VTAM Requirements 


Specifying 3270 Characteristics 


Two types of 3270 devices are supported by TSO/VTAM: 
non-SNA devices attached over a channel or through a 
bisynchronous fine protocol, and SNA devices attached 
by SDLC links. For non-SNA devices with a screen size 
larger than 24 X 80, or multiple screen sizes, or special 
features, and for SNA devices (LU2), you must provide a 
logmode table entry. 


Use the MODETAB and MODEENT macros to define the 
logmode table and its entry. The PSERVIC parameter 

of the MODEENT macro carries the screen sizes in row/ 
column form. If no logmode table entry exists for a 3270 
device, TSO/VTAM assumes it is non-SNA (LUO), and the 
buffer size specified by the SCRSIZE parameter of the 
TSOKEYOO member of PARMLIB (either 480 (12 X 40) 
or 1920 (24 X 80)). 


MODEENT Macro Instruction for Non-SNA 3270 Devices 


tabname MODEENT FMPROF=X’02’, 
TSPROF=X’02’, 
PRIPROT=X’71', 
SECPROT=X’40’, 
COMPROT=X’2000’, 
PSERVIC=&X’.......... er 


For example: 


Code the following MODEENT macro instruction for a 3270 
terminal having a screen size of 1920 characters: 


MODEENT! FMPROF=xX’'02’,TSPROF=X’'02’, 
PRIPROT=X’71',SECPROT=X’'40’, 
COMPROT=X'2000’, ,COS=cos name, 
PSERVIC=X’000000000000000000000200' 


1The FMPROF, TSPROF, PRIPROT, SECPROT, and 
COMPROT values are the same as those used in the IBM- 
supplied logon mode table, ISTINCLM. 
See ‘‘PSERVIC Operand of the MODENT Macro Instruc- 
tion.” 
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TSO/VTAM Requirements 


MODEENT Macro Instruction for SNA 3270 Devices 


modname MODEENT FMPROF=X’'03’, oom 
TSPROF=xX’03’, 
PRIPROT=X’B1’, 
SECPROT=X’90', 
COMPROT=X’'3080’, 


RUSIZES=X’8587', a 
COS=cos name, ‘ 
PSERVIC=X’.......... 1 “ 


The RUSIZES parameter above indicates a 256-byte maxi- 
mum secondary logical unit RU send size and a 1024-byte 
maximum primary logical unit RU send size. 


For example: ae 


Code the following MODEENT macro instruction for a 3270 
terminal having a primary buffer size of 1920 characters, and 
an alternate buffer size of 3440 characters: 


MODEENT FMPROF=X'‘03',TSPROF=X’03’, 
PRIPROT=X'B1',SECPROT=X’90’, 
CMPROT=X’'3080',RUSIZES=X'‘8587', 
COS=cos name, 
PSERV1IC=X'02000000000018502B507F’ = 





1See ''PSERVIC Operand of the MODENT Macro Instruc- 
tion.” 
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TSO/VTAM Requirements 


PSERVIC Operand of the MODEENT Macro Instruction 


PSERVIC operand as described below:'” 


PSERVIC=X’00. . OO000000.......... 00’ for non-SNA 
(LUO) 
X’02.. OOOO0O0O0O.......... 00’ for SNA 
. (LU2) 
) ME ee OO ders tee ae ee ae ese " device with- 
| out extended 
data stream 
capability 
Dre es ei OO CS. hc wee hee es in ee, te "device with 
extended 
data stream 
capability 
De cet daar ee 0000000001. .’ buffer size 
480 only 
, (12X40) 
inate aes es 0000000002. .’ buffer size 
1920 only 
(24X80) 
buffer sizes 
480 or 960 
(12X40) or 
12X80) 
buffer sizes 
1920 or 2560 
(24X80 or 
32X80) 
for buffer 
sizes 1920, 
3440 (24X80 
or 43X80) 
for buffer 
. sizes 1920, 
} 3564 (24X80 
; or 27X132) 


1 To prevent switching of screen sizes on a device that has 
more than one size possible, code the screen size to be used 
in the primary area of PSERVIC and a X'7E’ to indicate no 

) switching. For example: 


PSERVIC=X’...........- 1B8400007E..' for 3564 
buffer only 
2See ACF/VTAM Programming for details of the bit settings 
in the PSERVIC parameter, which represents bytes 13-24 of 
the session parameters. 


) Code the 12 bytes of device-specific hexadecimal data of the 





~ 


A Sen dee OC280C507F.. 


= 


> ee ate eee 185020507F. . 


- 


De 6 arth ace ee 18502B507F. . 





= 


Mie caren estas 18501B847F. . 
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Session: COS @ Interpret @ Logon Mode 


Defining Procedures to Establish Sessions 
Class of Service (COS) Tables 


Define a COS table by specifying a COSTAB macro, one or 
more COS macros, and a COSEND macro. 


csectnam COSTAB! where csectnam=ISTSDCOS 
[name] COS  VR=(vr#,tp#) 
((wr#,tp#) (vr#,tp#) 


(,...)) 
COSEND 


Interpret Tables 


Define each interpret table by one INTAB macro followed by 


at least one LOGCHAR macro, followed by one ENDINTAB | 


macro. 


[name] INTAB 
[name] . LOGCHAR APPLID=(APPLICID,appiname)| 
(ROUTINE,routinename) 
[,SEQNCE='characters’ ] 
[name] ENDINTAB 


Logon Mode Tables 


Define, create, or modify a logon mode table by specifying a 
MODETAB macro, one or more MODEENT macros, and a 
MODEEND macro. 


[name] MODETAB 

[name] MODEENT [LOGMODE=name] 
[, TYPE=value] 
[, FMPROF=value] 
[, TSPROF=value] 
[, PRIPROT=value] 
[, SECPROT=value] 


1 The IBM-supplied default is ISTVTCOS, which is used for 
example to establish CORM-to-CDRM sessions. 





Session: Logon Mode ® USS Definition 


{ COMPROT=value] 
. [, RUSIZES=value] 
} [ PSERVIC=value] 
3 [, PSNDPAC=value] 
[, SRCVPAC=value] 
[, SSNDPAC=value] 
[,ENCR=value]? 
) [,COS=name] 
[name] MODEEND 


USS Definition Tables 


: Create or modify USS definition tables with USSTAB, 
} USSCMD, USSPARM, USSMSG, and USSEND macro 
7 instructions. 


[name] USSTAB [TABLE=name] 
[name] USSCMD CMD=name 
[,REP=name] 
[,FORMAT=BALIPL1] 
[name] USSPARM PARME=pni|name 
[,REP=name] 
[,DEFAULT=value] 
[, VALUE=value] 
[name] USSMSG [MSG=n(n1,n2...)] 
[,TEXT='message text.]? 
[, BUFF ER=bufferaddress] ? 
[name] USSEND 





1 Applies to the Encrypt/Decrypt Feature only. 
2 TEXT and BUFFER are mutually exclusive. 
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Character Requests — USS Definition 


Character-Coded Requests and USS Definition Tables 


Using the IBM-supplied USS table, ACF/VTAM can accept a 
character-coded logon that has the following format: 


LOGON APPLID(name) LOGMODE (name) 
DATA(user data) 


In this format: 


e LOGON represents the function of logging on and must 
be specified first. 


e@e The APPLID parameter names the application program 
with which the LU wants to establish a session. 


@ The optional LOGMODE parameter indicates the entry in 
a.logon mode table where the session parameters desired 
for use in the session can be found. 


@e The optional DATA parameter contains data to be passed 
to the application program. 


ACF/VTAM expects to receive information in a character- 
coded logoff that has the following format: 


LOGOFF APPLID(name) TYPE(value) HOLD(value) 


In this format: 
@e LOGOFF represents the function for logging off. 


e The APPLID parameter names the application program 
with which the LU is in session. 


@e The TYPE parameter indicates whether or not the session 
is to be terminated at the discretion of the application 
program, 


@ The HOLD parameter indicates the disposition of the 
SSCP-to-PU session after the LU is no longer in session 
with the application program. 


If you want logons and logoffs entered at LUs in some other 
form, you have the following choices: 


e If the syntax of the logon and logoff commands is such 
that they can be translated to the character-coded logon 
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Character Requests — USS Definition 


format in the IBM-supplied USS table (these tables use 
PL/I syntax), you can: 


— Change the IBM-supplied default USS table. The de- 
fault table must contain the desired translation of the 
logon and logoff command into the required IBM 
format. This table will be used for an LU that has not 
been associated with a specific USS table. 


— Write supplementary USS tables and associate them 
with specific LUs. These tables must contain the 
desired translation of the logon and logoff commands 
into the required IBM format. 


For example, suppose that you wanted to use a logon format 
from a previous system: 


tL ACCOUNTS 


A replacement USS definition table could convert this to the 
standard USS format: 


LOGON APPLID(ACCOUNTS) LOGMODE(QUERY) 


e If the logons you want to use are such that a USS defini- 
tion table cannot be used to translate them into a format- 
ted command (for example they are not PL/I syntax), 
you can use an interpret table). 


The contents of the IBM-supplied USS table are shown in 
ACF/VTAM Planning and Installation Reference. \n chang- 
ing the IBM-supplied table or creating replacement or supple- 
mentary tables, you use USSTAB, USSCMD, USSPARM, 
USSMSG, and USSEND macro instructions. 


The USSTAB macro instruction indicates the beginning of a 
USS definition table. It can optionally specify the table to 
be used for character translation. 


The USSCMD macro instruction identifies a set of definition 


statements to be used to convert a user-defined command 
received from an LU. 
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Character Requests — USS Definition 


The USSPARM macro instruction identifies a user-defined 
keyword or positional parameter that can be coded in the 
user-defined command identified by the previous USSCMD 
definition. 


The USSMSG macro instruction allows you to tailor 
messages corresponding to different situations. The IBM- 
supplied table already contains messages for these situations, 
appropriate to most installations, but you may want to 
change the language. 


The USSEND macro instruction indicates the end of a USS 
definition table. 


To tell ACF/VTAM that a device supports character-coded 
messages and to indicate any input media control required 

by the device, specify the SSCPFM operand in the statement 
defining the device. To tell ACF/VTAM which USS table it 
should use in translating the character-coded commands from 
a particular LU, name the table in the USSTAB operand on 
the LU statement. 
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ACB @ CHECK e CLOSE e CLSDST 
PART 3. PROGRAMMING 


ACF/VTAM Macro Instructions 
| ) ACB—Create an Access Method Control Block 


[symbol ] ACB AM=VTAM 
[, APPL|ID=address of application 
program’s symbolic name] 
: } [,EXLST=exit list address] 
| [, MACRF=LOGON|NLOGON] 
[, PARMS=(NIB=nib address) ] 
[,PASSWD=password address] 


CHECK—Check Request Status 
J [symbol] CHECK RPL=rpl address 


CLOSE—Close One or More ACBs 


OS/VS only: 

- [symbol] CLOSE (acb address[,,acb address] .. .) 
VSE only: 
[symbol] CLOSE acb address[,acb address] ... 


CLSDST—Terminate Sessions in Which the Application 
Program Is Acting as the Primary Logical Unit 


} [symbol ] CLSDST RPL =rpl address 
~ [ rp! field name=new value] ... 


RPL fields that apply to CLSDST are: 





. AAREA=address of target N!IB=nib address 
) PLU’s symbolic name OPTCD=RELEASE|PASS 
~“" ACB=acb address OPTCD=SYN|ASY 
AREA =address of user PARMS=(THRDPTY= 
data for Initiate NOTIFY|NONOTIFY) 
ARG=(register) RECLEN=length of user 
) BRANCH=YES! |NO data 
4 { ECB=ecb address|INTERNAL } 
EX!T=rpl exit routine address 


1 Applies to MVS only. 
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EXECRPL @ EXLST @e GENCB 


EXECRPL—Execute a Request 


[symbol] EXECRPL RPL=rpl address | 
[,rpl field name=new value] ... 


All RPL fields apply to EXECRPL. 
EXLST—Create an Exit List 


[symbol] EXLST AM=VTAM 
[,DFASY= 
[,LERAD= 
[, LOGON= 
[ LOSTERM= 
[, NSEXIT= exit routine address] 
[, RELREQ= 
[,RESP= 
[,SCIP= 
[L.SYNAD= 
[ TPEND= 


GENCB—Generate a Control Block 


[symbol] GENCB BLK= { ACBIEXLST|RPLINIB 

,AM=VTAM 

[,keyword=value] ... 

[,COPIES=quantity ] 

[, WAREA=work area address, 
LENGTH=work area length] 

[,MF=list, generate, or execute form 
parameters | 


Keyword is any GENCB-supported keyword that can be used 
in the macro instruction corresponding to the BLK operand. 
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INQUIRE @ INTRPRET 


INQUIRE—Obtain Logical Unit Information or Application 
Program Status 


[symbol] INQUIRE RPL=rpl address 
[,rpl field name-new value] ... 


The setting of the specified RPL’s option code determines 
the type of INQUIRE to be performed. The option code can 
be: LOGONMSG, DEVCHAR, COUNTS, TERMS, 
APPSTAT, CIDXLATE, TOPLOGON, SESSPARM or 
SESSKEY. 


RPL fields that apply to INQUIRE are: 





ACB =acb address OPTCD=LOGONMSG| 

AREA =adadress of data area DEVCHAR|COUNTS| 
AREALEN=length of data area TERMS|APPSTAT| 
ARG=(register) CIDXLATE| 
BRANCH=YES?|NO TOPLOGON|SESSPARM| 


a a ease SESSKEY? 
EXIT=rpl exit routine address OPTCD=SYN|ASY 
N1IB=nib address 
INTRPRET—Interpret an Input Sequence 


[symbol] INTRPRET  RPL=rpl address 
[,rp! field name=new value] ... 


j RPL fields that apply to INTRPRET are: 


AAREA=interpreted ARG=(register) 
data area address BRANCH=YES!|NO 
AAREALN= ECB=ecb address| INTERNAL | 
) interpreted data aque exit routine address 
) area length N1IB=nib address 
ACB=acb address OPTCD=SYN|ASY 
AREA=input data RECLEN=input data length 


address 


1 Applies to MVS only. 
2 Applies to the Encrypt/Decrypt Feature only. 
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MODCB e NIB @e OPEN 
MODCB—Modify the Contents of Control Block Fields 


[symbol] MODCB AM=VTAM 

,ACB=acb address 
,EXLST=exit list address 
iNIB=nib address 
,RPL=rpl address 

field name=new value... 

[,MF=list, generate, or execute 

form parameters] 


NIB—Create a Node Initialization Block 


[symbol] NIB [BNDAREA=0|bind area address] 
[,ENCR=REQDISEL|NONE]? 
[,EXLST=exit list address] 
[, LISTEND=YES|NO] 
[,LOGMODE=0jC’ ‘|logon mode name] 
[ MODE=RECORD] 
[, NAME=name in configuration 
tables] 
[,RESPLIM=1 response limit] 
[, SDT=APPLISYSTEM] 
[,USERFLD=user data] 
([CAICSIRPLC] 
[| KEEP|TRUNC] 
[,NCONFTXT|CONFTXT] 
[,.NDFASYX|DFASYX] 
[,.NEGBIND|INNEGBIND] 
[, NRESPX|RESPX] 
[,ORDRESPINORDRESP] 
[,SYSRESP|APPLRESP] ) 





PROC= 


OPEN—Open One or More ACBs 


OS/VS only: 
[symbol] OPEN _ (acb address [,,acb address] ... ) 
VSE only: 


[symbol] OPEN acb address [,acb address] ... 


1 Applies to the Encrypt/Decrypt Feature only. 
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OPNDST e OPNSEC @ RCVCMD 


OPNDST—Establish Sessions in Which the Application 
Program Will Act as the Primary Logical Unit 


[symbol] OPNDST RPL=rpl address 
[ rpl field name=new value] .. . 


RPL fields that apply to OPNDST are: 


} AAREA=input area address for OPTCD=ACQUIRE| 


negotiable bind response ACCEPT 
AAREALN=length of input area OPTCD=CONANY| 
ACB=acb address CONALL 
BRANCH=YES! |NO OPTCD=CS|CA 





i. pin meant OPTCD=Q|NQ 
EXIT=rpl exit routine address OPTCD=SPEC|IANY 
N1IB=nib address OPTCD=SYNIASY 


OPNSEC—Establish a Session in Which the Application 
Program Acts as the Secondary Logical Unit 


[symbol ] OPNSEC RPL=rpl address 
[ rp! field name=new value] ... 


RPL fields that apply to OPNSEC are: 


ACB=acb address N1IB=nib address 

BRANCH=YES! |NO OPTCD=CSI|CA 

ECB=ecb address|INTERNAL OPTCD=SYN|ASY 
EX1!IT=exit routine address 





RCVCMD-—Receive a Message from ACF/VTAM 


[symbol ] RCVCMD RPL=rpl address 
} [,rpl field name=new value] ... 


RPL fields that apply to RCVCMD are: 


ACB=acb address ECB=ecb address| INTERNAL 
| AREA=input message EXIT=rpl exit routine ey 
) address OPTCD=Q\NQ 
| AREALEN=length of OPTCD=SY NIASY 
message area OPTCD=TRUNC 


BRANCH=YES|NO 


1 . 
Applies to MVS only. 
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RECEIVE @ REQSESS e RESETSR 


RECEIVE—Receive Input on a Session 


[symbol] RECEIVE  RPL=rpl address f 
[,rp! field name=new value] ... 0 ~— 


RPL fields that apply to RECEIVE are: 


ACB=acb address OPTCD=Q|NQ _ 

AREA=input data area OPTCD=SPEC|ANY | 
address OPTCD=SYN|ASY “— 

AREALENz=length of OPTCD=TRUCN|KEEP| 
input data area NIBTK 

ARG= (register) RTYPE=(DFSYN| ee 

BRANCH=YES! |NO NDFSYN,DFASY| | 

ECB=ecb address| INTERNAL NDFASY,RESP| — 

EXIT=rpl exit routine address NRESP) 
OPTCD=CAICS 


REQSESS-—Initiate a Session in Which the Application 
Program Will Act as the Secondary Logical Unit 


[symbol ] REQSESS  RPL=rpl address 
[,rpl field name=new value] ... 


Nee. 


RPL fields that apply to REQSESS are: 


AAREA=0 NIB=nib address 
ACB=acb address OPTCD=NQ jen 
ARE A-=address of user data OPTCD=SYNIASY 7 
for Initiate RECLEN#=user data 
BRANCH=YES? |NO length 
i ee 
EXIT=rpl exit routine address) are 


RESETSR—Cancel RECEIVE Operations and Switch a 
Session’s CS-CA Mode 


[symbol] RESETSR  RPL=rpl address 
[ rpl field name=new value] ... 








1 Applies to MVS only. 
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RESETSR @ RPL 


RPL fields that apply to RESETSR are: 


) ACB=acb address 
-” ARG=(register) 
BRANCH=YES!? JNO 


OPTCD=CA|CS 
OPTCD=SYNIASY 
RTYPE=(DFSYNINDFSYN, 


RESP|NRESP) 


ei sasha DFASY|INDFASY, 


EX!T=rpl exit routine address 


RPL—Create a Request Parameter List 


[symbol] 








) 


RPL AM=VTAM 


[, AAREA=alternate data area address] 

[ AAREALNE=alternate data area length] 

[, ACB=acb address] 

[, AREA=data area address] 

{ AREALEN=data area length] 

[, BRACKET=(BBINBB,EBINEB)] 

[,BRANCH=YES! |NO] 

[,CHAIN=FIRST|MIDDLE|LAST| 
ONLY] 

[,CHNGDIR=(CMD|NCMD, 
REQINREQ)] —~ 

[ ,CODESEL=STANDARDIALT] 

[,CONTROL=(DATA|BIDIBIS|CANCEL| 
CHASE|LUS|QC|RTRIQEC|RELQ| 
RSHUTDISBIISHUTC|SHUTD| 
SIGNAL|BINDICLEAR|ROR|SDT| 
STSN/UNBIND)] 

[,CRYPT=YESINO] ” 
,ECB=ecb address 
,“ECB=INTERNAL 
,EX|T=exit routine address 

[, IBSQAC=SETITESTSETIINVALID| 
IGNORE!|TESTPOS|TESTNEG| 
RESET] 

[,|,BSQVAL=inbound sequence number] 

{,N!B=nib address] 

[,OBSQAC=SETITESTSETI|INVALID| 
IGNORE|TESTPOS|TESTNEG| 
RESET] 





1 Applies to MVS only. 
* Applies to the Encrypt/Decrypt Feature only. 
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RPL 


RPL—Create a Request Parameter List (continued) 


[,OBSQVAL=outbound sequence 
number 

[, PARMS=(THRDPTY=NOTIFY| 
NONOTIFY)] 

[, POST=SCHED/RESP] = 

[,RECLEN=data length] 

[,RESPOND=EX|NEX,FMEINFME, 
RRNINRRN,ORESP|NORESP) ] 

[ RTYPE=(DFSYN|INDFSYN, 
DFASYINDFASY,RESP|NRESP)] eo 

[, SEQNO=sequence number] 

[,SIGDATAs=signal data] 

[, SSENSEO=0/CPMI|STATE|FIIRR] 

{ SSENSMO=system sense modifier 
value] 

[ STYPE=REQIRESP] 

| [, USENSEO=user sense value] 
OPTCD = ([,ACCEPT ACQUIRE] 

[,CAICS] 

[,CONALL|ICONANY] 

[,COND|UNCOND] 

{ LOGONMSG|IDEVCHAR| 
COUNTSITERMS|APPSTAT| je 
CIDXLATE|TOPLOGON| | 
SESSPARMISESSKEY! ] 

[, NEMHDRI|IFMHDR] 

(L,NIBTK|TRUNC|KEEP] 

[,QiNQ] a 

[,QUIESCE|STOPISTART] | 

[,RELEASE|PASS] 

[,RELRO|INRELRQ] 

[ SPECIANY] 

LSYNIASSY]) . 

a 


1 Applies to the Encrypt/Decrypt feature only. 
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SEND e SENDCMD 


SEND—Send Output on a Session 


y [symbol] SEND RPL=rpl address 
i [,rp! field name=new value] ... 


RPL fields that apply to SEND are: 





ACB=acb address OPTCD=SYNIASY 
AREA =output data address POST=SCHED|RESP 
ARG=(register) RECLEN=output data 
BRACKET=(BB|INBB,EB| length 
NEB) RESPOND=(EX| 
BRANCH=YES? |NO NEX,FME|INFME,RRN| 
CHAIN=FIRST|MIDDLE| NRRN,NORESP| 
LASTIONLY QRESP) 
CHNGDIR=(CMD|INCMD, RTYPE=(DESYN| 
REQ|INREQ) NDFSYN,DFASY'| 
CONTROL=DATA|BIDIBIS| NDFASY,RESP| 
CANCEL|CHASE|LUS|QC| NRESP) 
RTR|QEC|RELQ|RSHUTD| SEQNO=sequence 
SBIISHUTC|SHUTD| number 
SIGNAL SIGDATAz=signal data 
CODESEL=STANDARDIALT SSENSEO=CPM| 
CRYPT=YES|NO! STATEIFIJIRRIO 


ECB=ecb address|INTERNAL ) | SSENSMO=system sense 
EX1|IT=rpl exit routine address modifier value 


‘OPTCD=CAICS STYPE=REQ|RESP 
OPTCD=FMHDR| USENSEO=user sense 
NFMHDR value 





SENDCMD-—Send an ACF/VTAM Operator Command to 
ACF/VTAM 


[symbol] SENDCMD RPL=rp! address 
[,rp! field name=new value] ... 


) RPL fields that apply to SENDCMD are: 


ACB=acb address OPTCD=SYNI|ASY 
AREA=command address RECLEN=command 
BRANCH=YES? |NO length 


y J ECB=ecb address|INTERNAL 
_# \EXIT=rpl exit routine address 





? Applies to the Encrypt/Decrypt Feature only. 
2 Applies to MVS only. 
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SESSIONC e SETLOGON 


SESSIONC—Send a Session-Contro! Request or Response 


[symbol] SESSIONC RPL=rpl address 
[,rp! field name=new value] ... 


RPL fields that apply to SESSIONC are: 


ACB=acb address OBSQAC=SET|TESTSET| “ — 
ARG=(register) INVALIDIIGNORE| es 
BRANCH=YES?! |NO RESET|TESTPOS| 
CONTROL=SDT|CLEAR| TESTNEG 
STSN|RQORIBIND OBSQV AL=outbound 
ECB=ecb address|INTERNAL }) sequence. number _ 
EXIT=rpl exit routine OPTCD=SYN|ASY sae 
address RESPOND=(EX|NEX) 
IBSQAC=SET|TESTSET| SEQNO=sequence number 
INVALIDIIGNORE| SSENSEO=system sense 
RESET|TESTPOS| value | 
TESTNEG SSENSMO=system ~ 
IBSQV AL=inbound sense modifier value 
sequence STYPE=REQ|RESP 
number USENSEO=user sense ~ 
NIB=nib address value 


SETLOGON—Modify an Application Program’s Capability 
to Establish Sessions a 


[symbol] SETLOGON  RPL=rpl address 
[,rpl field name=new value] ... 


RPL fields that apply to SETLOGON are: aie 


ACB=acb address OPTCD=QUIESCE| ae 
BRANCH=YES! |NO STARTI|STOP 

ECB=ecb address|INTERNAL| OPTCD=SYNIASY 

EXIT=rpl exit routine address 





1 Applies to MVS only. 
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SHOWCEB e SIMLOGON 


SHOWCB—Extract the Contents of Control Block Fields 


) [symbol] SHOWCB AM=VTAM 
~ ,ACB=acb address 
,EXLST=exit list address 
,N1B=nib address 
’ »,RPL=rpl address 
) »AREA=data area address 
,FIELDS=field name|(field 
name,...) 
,LENGTH#=data area length 
{, MF=list, generate, or execute 
form parameters ] 





SIMLOGON-— Initiate a Session in Which the Application 
Program Will Act as the Primary Logical Unit 


[symbol] SIMLOGON  RPLe=rpl address 
[ rpl field name=new value] ... 


RPL fields that apply to SIMLOGON are: 


ACB=acb address OPTCD=CONANY |CONALL 
AREA=address of user OPTCD=Q|NQ 
“s data for Initiate OPTCD=RELRQ| 
} BRANCH=YES' |NO NRELRQ 


eo deere tena OPTCD=SYNIASY 
EX1IT=rpl exit routine address} RECLEN=length 
NIB=nib address of user data 


| ae 


1 Applies to MVS only. 
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TERMSESS @ TESTCB 


TERMSESS—Request Termination of a Session in Which 
the Application Program Acts as the Secondary 
Logical Unit 


[symbol] TERMSESS  RPL=rpl address 
[,rpl field name=new value] ... 


RPL fields that apply to TERMSESS are: 


ACB=acb address N1IB=nib address 
ARG= (register) OPTCD=COND| 
BRANCH=YES! |NO UNCOND 


ae address|INTERNAL OPTCD=SYNIASY 
EXIT=rpl exit routine address 


TESTCB—Test the Contents of a Control Block Field 


[symbol] TESTCB AM=VTAM. 

,~ACB=acb address 

,EXLST=exit list address 

,N1IB=nib address 

/RPL=rpl address 

[,ERET=error exit routine 
address] 
field name=test value 

[ ,MF=list, generate, or execute 
form parameters] 


1 Applies to MVS only. 
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ACB ERROR Field Values 


ERROR Applicable Explanation 

Field Value Macros 

(Hex) OPEN CLOSE 
0 ® e OPEN or CLOSE successful 
4 ® CLOSE already issued or 


ACB never opened 

Open cannot be processed 

because of a temporary 

shortage of storage 

The ACB’s password does 

not match the APPL entry’s 

password 

40 @ Outstanding OPNDST 
(ACQUIREs) not released 

42 @ System error prevented 
termination of one or more 
of the application program’s 

sessions 

46 ) e OPEN or CLOSE not issued 
in mainline program 

48 e CLOSE was not issued in 
a job step task, or ina 
subtask within the 
ACFI|VTAM partition.’ 

4C @ CLOSE was issued for a pro- 
gram operator application 
but there are messages 
queued for it, or ACF/VTAM 
is waiting for a reply, or both 

50 e e ACF/VTAM is not part of 
the operating system 


14 e 


24 e 


52 @ HALT was issued by the 
operator 

54 8 Invalid APPLID 

56 e APPLID is not an APPL 
entry 

58 e ACB’s symbolic name is 


the same as another ACB 
that is already open 


1 Applies to OS/VS1 only. 
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ACB ERROR Field Values (continued) 


ERROR Applicable Explanation 

Field Value Macros 

(Hex) OPEN CLOSE 

5A | e APPLID does not match any 


names in the ACF/VTAM 

| network configuration tables 
5C ® ACF/VTAM is inactive 

OE e Address in APPLID field is 

beyond the program’s 

addressable range 


60 e e System error 
62 8 Incorrect APPLID length byte 
64 @ Address in PASSWD field is 


beyond the program's 
addressable range 


66 e Incorrect PASSWD length 
byte 


68 re) OPEN was issued for a 
| primary program operator, 

when another primary 
program operator is already 

active . 

70 @ OPEN or CLOSE was issued 
unnecessarily while the 
program was terminating 
abnormally? 


88 e OPEN cannot be processed 
due to a temporary storage 
shortage.” 

BC @ ACB is being opened, or 


being closed by another 
CLOSE macro instruction 
F4 @ The application program is 
not authorized for 
SRBEXIT=YES.? 





1 Applies to OS/VS only. 
2 Applies to VSE only. 
3 Applies to MVS only. 
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ERROR 
Field Value 
(Hex) 


,” 





FA 


FE 


Applicable 
Macros 
OPEN CLOSE 


) ACB ERROR Field Vatues (continued) 


Explanation 


A communication network 
management (CNM) 
application program failed 
to supply a NIB pointer in 
the NIB field of the ACB, or 
the NIB address specified 
lies beyond the addressable 
range of the application 
program 

An application program 
without CNM authorization 
supplied a NIB pointer in its 
ACB, or if CNM authorized, 
the application program 
failed to supply valid NIB 
options on the NIB macro 
The CNM routing table 
indicated that this applica- 
tion program was to receive 
the same unsolicited 
formatted requests that 
were already being routed 
to another active CNM 
authorized application 
program 


97 


Manipulative Macro Instruction Return Codes 


Register 15 Explanation 


00 Successful completion 
04 Error—Register O set 
08 Error—Execute form of macro used to enter 
new item in parameter list—Register 0 not set 
Oc System Control Error—Register O set? 
aa) 
Return fs re S re 
Code Zz a Oo 
— (RegisterO) Oo Ss ~ Explanation 


For 04 in Register 15 


01 eee 
02 ee @ 
03 ee e 
04 ee 
05 @ 
06 @ 
07 ee 
08 e 
09 e @ 
0A e°e 
OB e 
Oc e 
OD 6 
OE ee 
OF e @ 
10 ee @ 
11 
For OC in Register 15' 
04 ee e@ 
08 ee @ 
oc eee 





1 Applies to VSE only. 
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Invalid request type 

Invalid block type 

Invalid keyword 

Invalid block 

Reserved (VSAM only) 
Reserved (VSAM only) 
Field nonexistent 
Insufficient main storage 
Insufficient program storage 
No address supplied 

RPL active 

ACB open 

Reserved (VSAM only) 
Invalid parameter list 
Invalid alignment 

Invalid control block (access 
method invalid) 

No internal ECB 


SIZE operand missing from 
program EXEC statement 
Attempt made to run in 

real mode | 

SIZE operand does not allow 
enough space for ACF/VTAM 
modules 


= 


e 











RPL-Based Macro Instruction Return Codes 


RTNCD 
Feedback 


00 
00 
00 
00 
00 


00 


04 
04 
08 
OC 
oc 


OC 
OC 
10 


10 
10 
10 
10 
10 


10 
10 
10 
10 
10 
10 


14 
14 
14 
14 
14 
14 


FDBK2_ Problem Definition 


Reason 

00 Normal completion or request accepted 

05 Input area too small 

06 No input available 

07 INQUIRE information not available 

08 OPNDST OPTCD=ACQUIRE, 
SIMLOGON, or CLSDST 
OPTCD=PASS failed 

09 OPNDST OPTCD=ACCEPT denied; no 
queued CINITs 

03 Exception request received 

04 Negative response received 

00 Temporary storage shortage 

0A Request canceled by RESETSR 

OB Request canceled because the session 
has been terminated 

OC Request canceled by Clear request 

OD Prior exception in chain detected 

00 Logical unit, application program 
status, or queued BIND not available 

01 OPNDST failed 

02 Logical unit inhibited for sessions 

03 HALT issued 

07 Request canceled by VARY command 

09 Unconditional Terminate or 
character-coded logoff received 

OA ACF/VTAM error 

OD ACF/VTAM inactive for your ACB 

OE Request aborted 

OF Buffers filled 

11 SDT failure on OPNDST 

12 Macro instruction failure, sense 
included 

00 VSAM request 

02 Zero EXIT field 

03 Zero ECB field 

04 Inactive RPL checked 

10 Control block invalid 

11 No RTYPE specified 
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RPL-Based Macro Instruction Return Codes (continued) 


_ RTNCD 


Feedback 


14 
14 
14 
14 
14 
14 
14 


14 
14 
14 
14 
14 
14 
14 
14 


14 
14 
14 
14 
14 


14 
14 


14 
14 
14 


FDBK2_ Problem Definition 


Reason 


12 
13 
1E 
23 
24 
3B 
3C 


40 
41 
42 
44 
47 
48 
49 
4A 


4B 
AC 
AD 
4E 
4F 


50 
51 


52 
53 
55 


CLSDST in progress 

CID invalid 

Invalid data or length 

Request type invalid 

Request invalid for address space? 
NFME-NRRN response 

Previous macro instruction 
outstanding 

CONTROL invalid 

Data traffic not allowed 

Invalid STYPE for SESSIONC 
RESPLIM exceeded 

3270 SEND option invalid 

Session control protocol! violation 
Invalid STSN action/result code 
Application program name not 
available 

INTRPRET sequence or LOGMODE 
invalid or cryptographic incompatibility 
Invalid search argument for INQUIRE 
or INTRPRET 

No interpret table 

Invalid use of NIB list 
ACQUIRE-ACCEPT option code 
invalid 

RPL field Invatid 

OPNDST OPTCD=ACCEPT and 
SIMLOGON not allowed 

NIB invalid 

Logical unit not found 

Application program not authorized, 
application program name not 
available, or task association not 
specified 





1 Applies to MVS only. 
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-. RPL-Based Macro Instruction Return Codes (continued) 


RTNCD FDBK2_ Problem Definition 
Feedback Reason 


14 57 Invalid MODE field 
~~ 14 5E CLSDST OPTCD=PASS not 
) authorized 
~~ 44 60 Invalid LU name for CLSDST or 
SESSIONC 
14 61 Invalid SETLOGON 
14 6C Exceeded limit on outstanding 
) RCVCMD requests 
y 14 6D Application program not authorized 
14 6E Syntax error in reply to ACF/VTAM 
operator message 
14 6F SENDCMD/RCVCMD processor 
inactive 
14 70 Program operator closing ACB with 
requests outstanding 
14 71 Operator command not valid 
14 73 SEND parameter invalid for CNM 
14 74 Negotiable response to non-negotiable 
BIND 
14 75 Invalid negotiable BIND response 
parameters 
>} 14 76 Invalid negotiable BIND response 
size 
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ZOOL 


How RPL-Based Macro Instruction Error and Special-Condition Information Is Organized 


For RPL-Based Requests 


After a SEND, RECEIVE, CHECK, or other RPL-based macro instruction, the next sequential instruction finds in 


Register 15 


The request was successful; or, for a synchronous request (including CHECK), the operation 


was successful. 
Some other value The request or the operation was not successful. 





Depending on the request and whether or not it was successful, it may be necessary to test 


Register O 


: If register 15 is zero, register O indicates (with a conditional completion return code) 
Completion code ‘ , : is : : 

for certain macro instructions whether success was conditional. If register 15 is not 
zero, register O can contain a return code from a LERAD or SYNAD exit routine 
or, if there is no LERAD/SYNAD exit routine, register 0 can contain a recovery 


Recovery code 
action return code (generally the code from the TRNCD field of the RPL), 





! 


If a request or operation was unsuccessful or conditionally successful, the following RPL fields can be exam- 
ined (in either the issuing routine or ina LERAD or SYNAD exit routine) to determine the cause of the exception. 


ae Oe ae 7 ' BOS ” . 
eS . ( CO 





COL 





Recovery action return code 


Specific error return code; or conditional completion 
return code if RTNCD=0 (equivalently, if register 15=0). 


Only set for certain System sense information 

macro instructions for 

certain RTNCD-FDBK2 

combinations. See System sense modifier information 
Appendix B in 

ACF/VTAM USENSEI 

Programming User sense information 





In addition, other RPL fields that contain feedback information (such as SEQNO, CHAIN, and CHNGDIR) 
normally used following completion of a requested operation may be used in determining how to handle an 
error or special condition. 


vol 


RPL fields are described under the RPL and other macro instruction descriptions in this manual, in the section 
titled, ‘““ACF/VTAM Macro Instructions” and are summarized in Appendix A of ACF/VTAM Programming. 


Possible RPL RTNCD,FDBK2, sense information settings and their meanings are described in this manual, in the 
section titled ‘‘ACB ERROR Field Values’’, and more fully in Appendix B of ACF/VTAM Programming. 


For Arrival of a Logical Unit Status Request 


After receiving input with a RECEIVE specifying RTYPE=(DFSYN,NRESP) and CONTROL=LUS, the RPL inbound 
sense fields (SSENSEI,SSENSMI, and USENSE]}) will contain error or special condition information from the 
logical unit. 


Register O is of interest in these circumstances 


For certain macro instructions with certain options set (see Appendix B of ACF/VTAM Programming), if register 
15 contains zero, success may be conditional. Register 0 should be examined to see if there is a condition (and 
what it is). | 


If an error occurred for an RPL-based request and no LERAD or SYNAD exit routine is available, register 15 
contains hex 04, and register 0 contains a recovery action return code. 


Ifa LERAD or SYNAD exit routine is available, it can set register 15 to zero to indicate ‘‘Error corrected — 
request or operation successful.”’ If the error is not corrected, register 15 should be nonzero and a return 
code can be passed from LERAD or SYNAD in register O. 


if the ACB was not opened, register O contains the RPL request code. 





SOL 





Recovery Active Return Code LERAD or SYNAD 
(In RPL RTNCD Field (Hex) Exit Scheduled Type of Completion Programmer Action 
oo No exit scheduled Normal or conditional Continue normal or conditional 
processing 











SYNAD Analyze RPL to choose logic path. 
SYNAD Retriable completion User EXECRPL macro to retry if 
desired. 


recovery coding. 


LERAD Dump program status and continue 
or abend. 
LERAD Logic error; RPL Dump program status and continue 
invalid or abend. Do not reuse this RPL. 
LERAD or SYNAD | RPL overwritten Pump presi amieretae end coneane 
or abend. Do not reuse this RPL. 


(in register O but not 
in RTNCD field) 










LOSTERM Exit Routine Reason Codes 


Reason Code 


Dec Hex Meaning 
Reserved 
Reserved 
Reserved 
12 Oc The session has been terminated. Immediate 


recovery is unlikely. The application pro- 
gram must issue CLSDST if it has not 
already done so. The cause of the session 
termination may preclude the session from 
being reestablished immediately. 


This reason code is only reported to a PLU 
application program. Some of the types 

of session outages that cause it are 

reported instead through a SCIP exit routine 
(if SONSCIP=YES on the APPL definition 
statement) or otherwise through an NSEXIT 
routine (if one exists). 


16 10 The session has been terminated. This 
reason code is reported immediately after 
reason code 24 (hex 18) (unless CLSDST 
has been issued) and is only reported after 
reason code 24. The application program 
may now try to reinitiate the session, for ex- 
ample, by issuing SIMLOGON or OPNDST 
OPTCD=ACQUIRE; however, the application 
program must first issue CLSDST if it has 
not already done so. 


Note: Once the CLSDST macro instruction 
has been issued, session initiation is subject 
to the normal rules. Therefore, if another 
logical unit has a queued session with the 
logical unit, the new session requested by 
the application program whose LOSTERM 
exit routine was invoked may not be im- 
mediately established. 


106° 


\ sy 
Se 


LOSTERM Exit Routine Reason Codes (continued) 


} Reason Code 


Dec Hex Meaning 
16 10 This reason code is only reported to a PLU 
(continued) application program. Many of the types of 
oy session outages that cause it are reported 
) instead through a SCIP exit routine (if 


SONSCIP=YES on the APPL definition 
statement) or otherwise through an NSEXIT 
exit routine (if one exists). 


20 14 A CTERM Forced request has been 
received. Perhaps the logical unit issued a 
Terminate Forced request, using 
TERMSESS OPTCD=UNCOND, for ex- 
ample. The application program must 
issue a CLSDST. When this completes, the 
application program may attempt to re- 
initiate the session. This reason code is only 
reported to PLU application programs. 





24 18 The session has been terminated. The 
LOSTERM exit routine will be immediately 
rescheduled with reason code 16 (hex 10) 
for this session. (See the reason code 16 
: description above.) The application program 
: may issue CLSDST at this time, which in turn 
) may cancel the execution of the LOSTERM 
i exit routine with reason code 16. 


This reason code is only reported to a PLU 
application program. The session outage 
can instead be reported through a SCIP or 
} NSEXIT exit routine as is described under 
as reason code 16. 


28 1C Reserved 
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LOSTERM Exit Routine Reason Codes (continued) 


Reason Code 
Hex 


20 


Dec 
32 


36 


24 


Meaning 


A CTERM Conditional request has been 
received. Perhaps the logical unit issued a 
Terminate Orderly request, using 
TERMSESS OPTCD=COND, for example. 
The application program can choose to 
issue CLSDST now or at some time in the 
future. The interpretation of the receipt of 
CTERM Conditional is not defined by SNA 
or ACF/VTAM. This reason code is only 
reported to a PLU application program. 


Received request or response units for this 
session have been discarded because of a 
lack of buffer space. The session has not 
been terminated, but session data recovery 
procedures are required. This reason 

code may be reported to either a PLU or 
SLU application program. For further 
details, see the description of (RTNCD, 

F DBK2)=(16,15) in Appendix B of 
ACF/VTAM Programming. 


Note: For any of the LOSTERM reason codes that require or 
recommend a CLSDST macro instruction, do not issue 

a second CLSDST if one has already been issued for the 

same session, but possibly for a different reason. 
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Session Outage Notification Summary 
Exit Routine Scheduled: 


(See Note 1) 


CLEANUP ae CLEANUP | No Exit Routine Scheduled 
UNBIND UNBIND An application program acting as a secondary 
logical unit must have an SCIP exit routine. 
oun No Exit Routine Scheduled 
or NSPE 


1. Read each row from left to right. The first nonblank column for which the exit routine is available 
represents the exit routine that will be scheduled and shows some of the key input to that exit routine. 

2. The SCIP exit routine (if available) is scheduled for a PLU (for UNBIND) only if SONSCIP=YES is coded 
on the APPL definition statement. For SONSCIP=NO, UNBIND is handled as if no SCIP exit routine 
were available. | 

3. If no LOSTERM exit routine is available, no exit routine is scheduled. 






Application 
Program Is: 













Secondary 
Logical 
Unit 










Notify 
or NSPE 





a 


Re! 





RPL REO Field Values 


Value 
(Dec) 


(21) 
(22) 
(23) 
(26) 
(27) 
(31) 
(34) 
(35) 
(36) 
(37) 
(39) 
(40) 
(41) 
(42) 
(44) 


Hex 


15 
16 
17 
1A 
1B 
1F 
22 
23 
24 
25 
27 
28 
29 
2A 
2C 


Macro Instruction 


SETLOGON 
SIMLOGON 
OPNDST 
INQUIRE 
INTRPRET 
CLSDST 
SEND 
RECEIVE 
RESETSR 
SESSIONC 
SENDCMD 
RCVCMD 
REOSESS 
OPNSEC 
TERMSESS 
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Parameter Lists for the EXLST Exit Routines 


Register 1 Parameter List 
Exit Routine 1st Word | 2nd Word 3rd Word 
DFASY ACB CID USERFLD 
address 


data‘* 
LERAD None (Register 1 contains the RPL 
address for the request that failed) 


ACB 
address 
zeros” 


LOSTERM ACB USERFLD 
address data* 


NSEXIT ACB CID USERFLD 
(for address data‘ 
CLEANUP 
RU) 
NSEXIT ACB Reserved USERFLD 
(for address data* 
ACB Reserved Reserved 
address 


Notify 
RU) 

11¢ the BIND request is a result of a REQSESS macro 
instruction, word 3 contains the USERFLD data from the 
NIB used with REQSESS; otherwise, word 3 contains Zeros. 

2 1f the LOGON exit routine is entered as a result of a 
SIMLOGON macro instruction, word 3 contains USERFLD 
data from the NIB used with SIMLOGON; otherwise, word 3 
contains zeros. 
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Address of the 
secondary 
logical unit's 
symbolic name 


USERFLD 
data or 






























NSEXIT 
(for 
NSPE 
RU) 









Pa 


Nee 


Parameter Lists for the EXLST Exit Routine (continued) 












4th Word 


DFASY 
LERAD 


LOGON 








Length 
of logon 
message 


LOSTERM Reason 
code 


~ 


(Cleanup) 






NSEXIT 
(Notify) 








NSEXIT 
(NSPE) 


Register 1 Parameter List 


Reserved | Address of 
ready-only RPL 


None (Register 1 contains the RPL 
address for the request that failed) 


























6th Word 


Reserved 


5th Word 





Address of 
read-only RPL 
(RPL contains 
the address of 
the CINIT RU.) 






Reserved 


Address of Reserved 
read-only RPL 

(RPL contains 

address of 

CLEANUP RU.) 

Address of Reserved 
read-only RPL 


Reserved 






(RPL contains 
address of 
Notify RU.) 





Address of 
read-only RPL 
(RPL contains 
address of 

NSPE RU.) 










B Word scontaine data 4c 3 contains data from the NIB used with REQSESS, 
SIMLOGON, or CLSDST OPTCD=PASS. 
*Word 3 contains data from the NIB used with OPNDST 


or OPNSEC. 
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ae 
Parameter Lists for the EXLST Exit Routines (continued) 
Register 1 Parameter List a 
Exit Routine | 1st Word | 2nd Word 3rd Word ee 
RELREO ACB Address of the Reserved 
address | secondary 
logical unit's a 
symbolic 
name estas 
RESP ACB CID USERFLD 
address data? 
ACB CID USERFLD 
address data or | bed 
zeros! 
SCIP ACB CID USERFLD? 
(for address 
other than 
BIND RU) ve 
SO 
None (Register 1 contains the RPL 
address for the request that failed) a 
ee 


TPEND ACB Reason-code Reserved 
address 


11 the BIND request is a result of a REQSESS macro 
instruction, word 3 contains the USERFLD data from the 
NIB used with REQSESS; otherwise, word 3 contains zeros. 

Word 3 contains data from the NIB used with OPNDST 
or OPNSEC. 
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Parameter Lists for the EXLST Exit Routines (continued) 


Register 1 Parameter List 
Exit Routine 4th Word | 5th Word 6th Word 


7 7 


Reserved | Address of Reserved 
read-only RPL 


SCIP Address Address of Reserved 
(Bind) of the read-only RPL 

session (RPL contains 

param- the address of 

eters the BIND RU.) 


SCIP Reserved | Address of Reserved 
(for other read-only RPL 
than BIND (For UNBIND, 
RU) the RPL con- 
) tains the address 
of the UNBIND 
RU.) 


None (Register 1 contains the RPL 
address for the request failed) 
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Macro Instructions That Create DSECTs 


Control Block 
ACB 


EXLST 
RPL 


Device character- 
istics field in NIB 

Processing options 
field in NIB 

RTNCD-FDBK2- 
FDBK fields 
in RPL 

NIB 

Session parameters 

Program operator 
message and 
command header 


DSECT Name 
and Operands 


IFGACB 
IFGEXLST 


IFGRPL 


ISTOVCHR 


ISTDPROC 


ISTUSFBC 
ISTONIB 
ISTDOBIND 


ISTDPOHD 


AM=VTAM 
[,DSECT=YES|NO] 
AM=VTAM 
[,DSECT=YESINO] 
AM=VTAM 
[,DSECT=YESINO] 


[, DSECT=YES/NO] 


[,DSECT=YES|NO] 


In coding these macro instructions, do not use elsewhere 


in the program any label beginning with: 


ACB IFG 
BIN IST 
DEV NIB 
EXL POH 
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PRO 
RPL 
RSV 
USF 


( 





PART 4. SNA REFERENCE DATA 


Format of BNDAREA (ISTDBIND) 


Primary LU 


[PRIPROT] 
(BINPRIP) 


Secondary 
Send Pacing 
[SSNDPAC] 
(BINAPACE) 


Primary Send 
Pacing Count 
[PSNDPAC] 

(BINSPACE) 


User Data 


(BINUSEL) 


Displacement 
Dec Hex 
0 0 
BIND BIND FM Profile TS Profile 
Format Type [FMPROF] {[TSPROF] Protocols 
[TYPE] 
(BINFMT) | (BINTYPE) | (BINFM) (BINTS) 
4 4 
Secondary LU Common LU Protocols 
Protocols [COMPROT] 
[SECPROT] 
(BINSECP) (BINCMNP) (BINCMNP2) 
8 8 
Secondary Maximum Request 
Receive Unit Send Sizes 
Pacing Count (RUSIZES) 
{[SRCVPAC] Secondary LU] Primary LU 
(BINRPACE) (BINSRUSZ) (BINPRUSZ) 
12 Cc 
Presentation 
Primary Receive Services 
Pacing Count Profile 
{PSERVIC] 
(BINBPACE) (BINLUP) 
16 10 
Logical Unit Presentation Services Usage Field 
(PSERVIC] 
20 14 
(BINPSCHR) 
24 18 
Length of 
Cryptographic § Primary LU 
control name 
(BINCRCTL) (BINPRIML) 
28 1C 
Name of Primary Logical Unit 
32 20 (BINPRIMN) 
Length 
36 24 


User Data 
(BINUSE) 


The heavily outlined section is the fixed-length portion of BIND. 
The names in brackets are the operands of the MODEENT macro 
used to build the corresponding fields in a logon mode table entry 
For further information refer to the ACF/VTAM Planning and 
Installation Reference manual. The names in parentheses are the 


ISTDBIND DSECT labels for the field. 
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Index of RUs by NS Headers and Request Codes 


Hex 
Value 


010002 


010003 
010004 


010201 

010202 
010203 
010204 
010205 
010206 
010207 
010208 
010209 
01020A 
01020B 
01020E 
01020F 
010211 


010214 
010215 
010216 
010217 
010218 
010219 


01021A 
01021B 
010222 


1, 010280 
» 010281 
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RU Name 


Change Negative 
Response Poll Limit 

Change Session Limit 

Chg Service Seeking 
Pause 

Contact 

Discontact 

IPL Initial 

IPL Text 

IPL. Final 

Dump Initial 

Dump Text 

Dump Final 

Remote Power Off 

Activate Link 

Deactivate Link 

Connect Out 

Abandon Connection 


Set Control Vector 


(Configuration 
Services) 
Entering Slowdown 
Exiting Slowdown 
Activate Connect In 
Deactivate Connect In 
Abandon Connect Out 
Assign Network 
Address 
Free Network Address 
Request Discontact 
Set Control Vector 
(Configuration 
Services) 
Contacted 
Inoperative 


RU 
Category 


FMD 


FMD 
FMD 


FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


FMD 
FMD 
FMD 


FMD 
FMD 


ACF/ 
VTAM 
Control 
Block 


NSRU 
NSRU 
AINRU 
DINRU 
ACNRU 
ANARU 


FADRU 
MSVRU 


KTDRU 
INPRU 





Hex 
Value 


010284 
010285 
0102F FAO 
0102FFA1 
0102FFA2 
0102FFA3 
010301 
010302 
010303 
010311 


010331 
010334 
010380 
010381 


010382 
010383 
010604 


010681 
010683 


02 
03 
04 
04 
05 
05 
06 


07 
08 
09 
OA 


RU Name 


Request Contact 

NS Lost Subarea 

Allocate Resource 

Free Resource 

Set Routable State 

Reset Routable State 

Execute Test 

Activate Trace 

Deactivate Trace 

Set Control Vector 
(Maintenance 
Services) 

Display Storage 

Record Storage 

Request Test 

Record Maintenance 
Stats 

Record Test Data 

Record Trace Data 

Net Services Proc 
Error 

Initiate Self Format-O 

Terminate Self 
Format-O 

NC IPL Final 

NC IPL Initial 

NC IPL Text 

Logical Unit Status 

Ready to Receive 

Lost Subarea 

Explicit Route 
Inoperative 

ANS Complete 

Lost Path 

Explicit Route Test 

Explicit Route Test 
Reply 


index of RUs 


RU 
Category 


FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


FMD 
FMD 
FMD 
FMD 


FMD 
FMD 
FMD 


FMD 
FMD 


NC 
NC 
NC 
DFC 
DFC 
NC 
NC 


NC 
NC 
NC 
NC 


ACF/ 
VTAM 
Control 
Block 


ROQCRU 
LSARU 
ALRRU 
FRERU 
RTARU 
RTIRU 


MSVRU 


DSTRU 


RSTRU 


NSRU 


NSRU 


NSPE 


ISHDR 
TMRU 


LUSRU 


LSARU 
ERIRU 


ANCRU 


ETSRU 
ETRRU 
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Index of RUs 


Hex 
Value 


OB 


OC 


OD 


OD 


OE 


OE 


OE 


10 


11 
12 


14 
14 


15 
31 
32 
410210 


41021C 
41021D 
41021E 
410221 

410223 
410235 


410236 
410237 


RU Name 


Explicit Route 
Activate 

Explicit Route 
Activate Reply 

Activate Logical Unit 

Activate Virtual Route 

Deactivate Logical 
Unit 

Deactivate Virtual 
Route 

Explicit Route 
Operative 

Explicit Route 
Activated 

Activate Physical Unit 

Deactivate Physical 
Unit 

Activate CDRM 

Activate CORM 
Response 

Deactivate CDRM 

Bind Session 

Unbind Session 

Request Net Addr 
Assign 

Delete Network 
Resource 

Explicit Route 
Inoperative 

Add Link 

Add Link Station 

Virtual Route 
Inoperative 

Initiate Procedure 

Procedure Status 

Load Required 


RU 
Category 


NC 
NC 
SC 
NC 
SC 
NC 
NC 


NS 


SC 
SC 


SC 
SC 


SC 
SC 
SC 
FMD 


FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


FMD 
FMD 


ACF/ a 
VTAM Of” 
Control Nw 
Block 
ERARU 
EARRU 
ALURU 
VRARU 
- = 
VRDRU)  \_ 
ERORU 
“ 
APURU 
DPURU 
ACTCD “ 
APRRU 
DACTC 
BIND ee 
UNBRU \_| 
RADRU 
z a 
Se Ss 


Hex 
Value 


410240 


410240 


410243 
410244 
410245 
410246 
410285 
410286 


410286 


410287 


4102FF10 


4102FFBD 
4102FFBE 
4102FFBF 


4102FFCD 
4102FFCE 


4102F FCF 


410304 


410305 
410306 
410384 
410385 
410386 
4106FF01 
4106F FO2 
50 


RU Name 


Request Activate 
Logical Unit 

Add Network 
Resource 

NS IPL Initiate 

NS IPL Text 

NS IPL Final 

NS IPL Abort 


_ Lost Subarea 


Req Delete Net 
Resource 

Request Free Network 
Address 

Network Services Lost 
Control Point 

Request Network 
Address Assignment 

Add Link 

Add Link Station 

Delete Network 
Resource 

Request Dump 

Request Conditional 
Load 

Request Unconditional 
Load 

Request Maintenance 
Statistics 

Enter Test Mode 

Request Route Test 

Record Formatted MS 

Record Test Results 

Explicit Route Tested 

OPEN ACB 

CLOSE ACB 

NCP Init Complete 


Index of RUs 


RU 
Category 


FMD 


FMD 


FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


FMD 


FMD 


FMD 


FMD 
FMD 
FMD 


FMD 
FMD 


FMD 


FMD 


FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
NC 


ACF/ 
VTAM 
Contro/ 
Block 


ANRRU 


LCPRU 
RNARU 
PLKRU 
PSTRU 
DNRRU 


RDPRU 
RLDRU 


RLDRU 


index of RUs 


Hex 
Value 


51 


52 


63 


70 
71 


80 


81 

810320 
810386 
810387 
810389 
810601 
810602 
810620 
810629 
810680 
810681 
810682 
810683 


810685 
810686 
810687 
810688 


8106F F80 


810810 
810812 


8108FFO1 


818620 
818627 
818640 


RU Name 


Switch line EP to 
NCP mode 

Switch line NCP to 
EP mode 

Service Manager 
Parameter List 

Bracket Init Stopped 

Stop Bracket 
Initiation 

Quiesce At End Of 
Chain 

Quiesce Complete 

Notify 

Explicit Route Tested 

Request Echo Check 

Echo Test 

Control Initiate 

Control Terminate 

Notify 

Cleanup Session 

Initiate Other 

Initiate Self Format-1 

Terminate Other 

Terminate Self 
Format-1 

Bind Failure 

Session Started 

Unbind Failure 

Session Ended 

Reallocate 

Forward 

Deliver 

Notify 

Cross-Domain Notify 

Direct Search List 

Cross-Domain Init 
Other 


RU 
Category 


NC 


NC 


FMD 


DFC 
DFC 


DFC 


DFC 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


FMD 
FMD 
FMD 
SSE 

FMD 
FMD 
FMD 
FMD 
FMD 
FMD 
FMD 


ACF/ 
VTAM 
Control 
Block 


ROQERU 
ECTRU 
CTLIN 
CTERM 
NOTRU 
CLNUP 
INITO 
ISHDR 
TMRU 
TMRU 


BFA 
SSSRU 
UBFRU 


RELOC 
FWDRU 
DLVRU 
NAMRU 
NOTRU 
DSL 
CRDIO 


Nw 


fos 


ee 





eal 


Hex 
Value 


818641 
818642 


818643 


818645 


818646 
818647 


818648 
818649 


81864A 


81864B 
82 
83 
84 
AO 
Al 
A2 


A3 
CO 
Co 
C1 
C2 
C8 
C9 
FFO1 


FFO1 
FFO1 


FFO2 


RU Name 


Cross-Domain Initiate 

Cross-Domain Term 
Other 

Cross-Domain 
Terminate 

CD Session Setup 
Failure 

CD Session Started 

CD Session Takedown 
Failure 

CD Session Ended 

Cross-Domain 
Takedown 

CD Takedown 
Complete 

CD Control Initiate 

Release Quiesce 

Cancel 

Chase 

Start Data Traffic 

Clear 

Set and Test Sequence 
Nos 

Request Recovery 

Cryptography Verify 

Shutdown 

Shutdown Complete 

Request Shutdown 

Bid 

Signal 

Virtual Route 
Inoperative 

Purge Chain Element 

Notify (drive 
LOSTERM) 

Set Session Address 


RU 
Category 


FMD 
FMD 


FMD 
FMD 


FMD 
FMD 


FMD 
FMD 


FMD 


FMD 
DFC 
DFC 
DFC 
SC 
SC 
SC 


SC 

SC 

DFC 
DFC 
DFC 
DFC 
DFC 
FMD 


AMR 
FMD 


FMD 


Index of RUs 


ACF/ 
VTAM 
Control 
Block 


CDIN 


CDTRM 


CDSF 


CSESS 


CRSE 
DTAKD 


_ 123 


Index of RUs 


Hex 

Value RU Name 

FFO3 Set Session Address 

| with Disconnect 

FFO4 Override Session 
Address 

FFO5 Purge Wait Queue 

FFOG Flush Virtual Route 
Sessions 

FFOB Request Explicit 
Route Activate 

FFOE Request Virtual Route 
Deactivate 

FF31 Generic Bind 

FF32 Generic Unbind 

FFFF Virtual Route Status 
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RU 
Category 


FMD 
FMD 


FMD 
FMD 


FMD 
FMD 
FMD 


FMD 
FMD 


ACF/ 
VTAM 
Control 
Block 
AMRU 
AMRU 


AMRU 
AMRU 


RAERU 
RDVRU 
GBIND 


GUNB 
VRSRU 


a> 


hasan 


Any 


Ae 





Logical Unit Presentation Services Profiles and 
Protocols’ 


LU Type 0 


Use of a set of protocols and data streams agreed upon by 
the logical units involved; SNA does not define them 


LU Type 1 


Use of an SNA character string (SCS) and a defined set of 
SNA protocols for a keyboard/printer device 


Use of predefined function management headers to identify 
a variety of data set types and controls that can be sent and 
received 


LU Type 2 


Use of a 3270 data stream and a defined set of SNA 
protocols for a keyboard/display device 


LU Type 3 


Use of a 3270 data stream and a defined set of SNA 
protocols for a printer 


LU Type 4 


Use of an SNA character string (SCS) and a defined set of 
SNA protocols for a batch input/output LU having associated 
with it a printer and a magnetic stripe reader/recorder 


LU Type 6 


Use of SNA character string (SCS) and structured field data 
streams between application programs in a distributed 
processing environment 


1 Refer to Systems Network Architecture: Sessions between 
Logical Units, GC20-1868, and Systems Network 
Architecture: Concepts and Products, GC30-3072, for 
additional information. 
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Transmission Services Profiles 


Session Control Requests for Each Transmission Services Ny 
Profile 


Transmission Services Profile 









f 
Session Control Request Mi 
—_ 
—— 
Key: Req — This request must be used. The required 
requests may be issued by ACF/VTAM 
on behalf of the application program. a 
Opt — This request may be used. 
NA — Not applicable. e 
ae 
( 
Ns 





1 Refer to the Systems Network Architecture Reference 
Summary, GA27-3136, for additional information. 
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Transmission Services Usage Field Request Unit Size’ 


The session parameters specify the maximum length of 
request units that can be sent by the logical units. This 
information is divided into two parts: the secondary logical 
unit send request unit size (byte 9) and the primary logical 
unit send request unit size (byte 10). Both bytes have the 
same format; however, they may be set to different values 
depending upon the requirements of the logical units. The 
bits that can be set are listed below. 


Caution: The displacements indicated below apply to the 
ISTDBIND DSECT. These displacements are one greater 
in the actual BIND RU, since the BIND RU contains a 
request code that is not contained in the ISTDBIND 
DSECT. 


Bit Setting 
(Bytes 9 and 10) 
0123 4567 Meaning 


O... .... (byte 9) 6K bytes is the default size of 
the request unit that can be sent. 


O...  .... (byte 10) There is no limit specified for 
the size of the request unit that can be 
sent. 

1000 .... This is the mantissa (m) of the formula 
m (2") used to determine the length of 

through : 
request units that can be sent by the 

1111 ead primary or secondary logical unit. 


0000 _ This is the exponent (n) of the formula 
m (2") used to determine the maximum 
length of request units that can be sent 

1111 =~ by the primary or secondary logical unit. 


through 





1 Refer to the Systems Network Architecture Reference 
Summary, GA27-3136, for additional information. 
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Bits 4-7(n) 












Bits 4-7(n) 
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RU Size 
Byte 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


RU Size 
Byte 


OMAN DOO ARWBN — OO 








8 


8 

16 

32 

64 

128 
256 
512 
1024 
2048 
4096 
8192 
16384 
32768 
65536 
131072 
262144 


Cc 
(12) 


24 

48 

96 

192 
384 
768 
1536 
3072 
6144 
12288 
24576 
49152 
98304 
196608 
393216 


9 


18 

36 

72 

144 
288 
576 
1152 
2304 
4608 
9216 
18432 
36864 
73728 
147456 
294912 


D 
(13) 





26 

52 

104 
208 
416 
832 
1664 
3328 
6656 
13312 
26624 
53248 
106496 
212992 
425984 


A 
(10) 


20 

40 

80 

160 
320 
640 
1280 
2560 
5120 
10240 
20480 
40960 
81920 
163840 
327680 


E 
(14) 


28 

56 

112 
224 
448 
896 
1792 
3584 
7168 
14336 
28672 
57344 
114688 
229376 
458752 





B 
(11) 


11 
22 

44 

88 

176 
352 
704 
1408 
2816 
5632 
11264 
22528 
45056 
90112 
180224 
360448 


| Bits 0-3(m) 


= 
(15) 


15 
30 

60 

120 
240 
480 
960 
1920 
3840 
7680 
15360 
30720 
61440 
122880 
245760 
491520 











Sense Codes 


Sense Codes 


The information in this section is adapted from information 
presented in the SVA Format and Protocol Reference 
Manual: Architectural Logic, SC30-3112, and is provided 
es here for the convenience of the reader. Although the infor- 
) mation was accurate at the time it was published, it is subject 
to change. The manual cited above should be regarded as the 
official source of this information. 


The sense data included with an exception request (EXR),a 

= negative response, or a send check is a 4-byte field (see 

) below) that generally includes a 1-byte category value, a 

_ 1-yte modifier value, and 2 bytes of implementation- or 
end-user-defined data (hereafter referred to as user-defined 
data). For certain sense codes, user-defined data cannot be 
included in the sense data (it is never carried in send-check 
sense data); in its place is sense code specific information, 

whose format is defined along with the sense code definition, 
below. 


Byte 


Sense code specific 


Category | Modifier | fields or user-defined 
data 





|< Sense Code —>| 


Together, the category and modifier bytes hold the sense 
= code (SNC) defined for the exception condition that has 


) occurred. 
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Sense Codes 


The following categories are defined; all others are reserved: 


Hex 

Value Category 

00 User Sense Data Only 

08 Request Reject 

10 Request Error 

20 State Error 

40 Request Header (RH) Usage Error 
80 Path Error 


The category ‘‘user sense data only”’ (hex 00) allows the end 
users to exchange sense data in bytes 2-3 for conditions not 
defined by SNA within the other categories (and perhaps 
unique to the end users involved). The modifier value is also 
hex O00. 


The sense codes for the other categories are discussed below. 
For these categories, a modifier value of hex O00 can be used 
(as an implementation option) when no definition of the 
exception condition beyond the major category is to be 
identified. 
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Sense Codes 


Request Reject (Category Code Hex 08) 


This category indicates that the request was delivered to the 
intended half-session component and was understood and 


supported, but not executed. 


Sense Code 
) (Hex) 


0801 


0802 


0803 
0804 


0805 


Meaning 


Resource Not Available: The LU, PU, or 
link specified in an RU is not available. 


Intervention Required: Forms or cards are 
required at an output device, or a device is 
temporarily in local mode, or other condi- 
tions require intervention. 


Missing Password: The required password 
was not supplied. 


Invalid Password: The password was not 
valid. 


Session Limit Exceeded: The requested 
session cannot be activated, as one of the 
NAUs is at its session limit. Applies to 
ACTCDR\M, INIT, BIND, and CINIT 
requests. 


Resource Unknown: The request contained 
a name or address not identifying a PU, LU, 
link, or link station known to the receiver. 


Resource Not Available—LUSTAT 
Forthcoming: A subsidiary device will be 
unavailable for an indeterminate period of 
time. LUSTAT will be sent when the device 
becomes available. 


Invalid Contents ID: The contents ID con- 


tained on the ACTCDRM request was found 
to be invalid. 
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Sense Codes 


Sense Code 
(Hex) 


0809 


O80A 


080B 


O080C 


O80D 


O80E 


132 


Meaning 


Mode Inconsistency: The requested func- 
tion cannot be performed in the present 
state of the receiver. 


Permission Rejected: The receiver has 
denied an implicit or explicit request of the 
sender; when sent in response to BIND, it 
implies either that the secondary LU will 
not notify the SSCP when a BIND can be 
accepted, or that the SSCP does not recog- 
nize the NOTIFY vector key hex OC. (See 
the hex 0845 sense code for a contrasting 
response.) 


Bracket Race Error: Loss of contention 
within the bracket protocol. Arises when 
bracket initiation/termination by both 
NAUs is allowed. 


Procedure Not Supported: A procedure 
(Test, Trace, IPL, REQMS type) specified 
in an RU is not supported by the receiver. 


NAU Contention: A request to activate a 
session was received while the receiving half- 
session was awaiting a response to a pre- 
viously sent activation request for the same 
session; for example, the SSCP receives an 
ACTCDRM from the other SSCP before it 
receives the response for an ACTCDRM that 
it sent to the other SSCP and the SSCP ID 
in the received ACTCDRM was less than or 
equal to the SSCP ID in the ACTCDRM 
previously sent. 


NAU Not Authorized: The requesting NAU 


does not have access to the requested 
resource. 


Nes 
\ 


et 


( 


- 


\ 


ee 


St, 


h 4 
an 
t 





Sense Code 


~~ (Hex! 
J O80F 


0812 


0813 


0814 


joes 


-~ 0816 


Sense Codes 


Meaning 


End User Not Authorized: The requesting 
end user does not have access to the re- 
quested resource. 


Missing Requester 1D: The required re- 
quester 1D was missing. 


Break: Asks the receiver of this sense code 
to terminate the present chain with 
CANCEL or with an FMD request carrying 
EC. The half-session sending the Break 
sense code enters chain-purge state when 
Break is sent. 


Insufficient Resource: The receiver cannot 
act on the request because of a temporary 
lack of resources. 


Bracket Bid Reject—No RTR Forthcoming: 
BID (or BB) was received while the first 
speaker was in the in-bracket state, or while 
the first speaker was in the between-brackets 
state and the first speaker denied permission. 
RTR will not be sent. 


Bracket Bid Reject—-RTR Forthcoming: 
BID (or BB) was received while the first 
speaker was in the in-bracket state, or 
while the first speaker was in the between- 
brackets state and the first speaker denied 
permission. RTR will be sent. 


Function Active: A request to activate a 
network element or procedure was received, 
but the element or procedure was already 
active. 


Function Inactive: A request to deactivate 
a network element or procedure was 
received, but the element or procedure was 
not active. 
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Sense Codes 


Sense Code 
(Hex) 


0817 


0818 


0819 
081A 


081B 


081C 


134 


Meaning e 
ae 

Link Inactive: A request requires the use of 

a link, but the link is not active. 


Link Procedure in Process: CONTACT, ; 
DISCONTACT, IPL, or other link procedure a 
was in progress when a conflicting request ad 
was received. 


RTR Not Required: Receiver of Ready to 
Receive has nothing to send. 


Request Sequence Error: Invalid sequence Ney 
of requests. 


Receiver in Transmit Mode: A race condi- 

tion: normal-flow request received while 

the half-duplex contention state was not- 
receive, (*S, R), or while resources (such as é 
buffers) necessary for handling normal-flow 

data was unavailable. (Contrast this sense 

code with hex 2004, which signals a protocol 
violation.) 


Request Not Executable: The requested 
function cannot be executed, because of a 


permanent error condition in the receiver. =~ 


The following list shows ACF/VTAM- ‘<2 


unique codes that are set as part of sense 
code 081C. 


OS/VS User Sense Codes for Request Load 6 ~ 
(Conditional) and Request Load . 
(Unconditional) Request Units . 


Sense Data Meaning 


081C0008 ACF/VTAM is unable to; 
successfully open the data “ 
set containing the NCP 
load module. 





Sense Data 


081C0014 


081C0018 


081C001C 


081C0020 


08 1C0024 


081C002C 


081C0030 


Sense Codes 


Meaning 


The loaded NCP has 
encountered an error pre- 
venting successful 
initialization. 


Load not performed — 
HALT is in progress. 


The 3705 dump/load/ 
restart router (module 
ISTINCDP) has received 
an input work element 
which contains an un- 
recognized command 
code. The NCP load 
module is not present in 
the load module data set 
(BLDL failure). 


A permanent I/O error 
has occurred on the 
3705. 


ACF/VTAM is unable to 
successfully open the data 
set containing the 
diagnostics programs 
(ddname “INITTEST"’). 


The diagnostic program has 
detected a probable 3705 
hardware error. 


The NCP or diagnostics 
program load module has a 
block size greater than 
1024 bytes (the ‘‘DC” 
option was not specified 
when the link-edit was 
performed). 
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Sense Codes 
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Sense Data 


081CO03C 


081C0040 


08100044 


081C004C 


081C0050 


081 C0054 


081C0058 


081 CO05C 


Meaning 
— 
The 3705 unit control ae 
ee 
block does not contain a 
valid value for the channel 
adapter type field. 
So 


The NCP or diagnostics [ 
program load module is Ta 
improperly constructed. 


The IFLOADRN 3705 
load utility program is o> 
unable to allocate 
sufficient storage. 


\ 


The NCP load module size 
exceeds the storage 
capacity of the 3705. 


A permanent I/O error has 
occurred on the NCP load 
module library. 


A permanent I/O error has 
occurred on the diagnostics 
program load module 

library (ddname ne 
“INITTEST"’’). 


A diagnostics program can- 

not be located in the 

diagnostics program load 
module library (ddname ep 
“INITTEST”’) —BLDL’  —_(\__ 
failure. 


Request Load (Condi- 
tional) is attempted while 
another host is already 
loading the 3705 (unit 
exception on SENSE 
channel program). 





Sense Codes 


Sense Data Meaning 
) 081C0060 Request Load (Condi- 
tional) is attempted while 


another host is already 
loading the 3705 (Start 
[/O condition code = 3 
= on SENSE channel 
) program). 


081 C0064 A Load I/O operation 
(to a link-attached 3705) 
has been purged (by Vary 
Deactivate or error 
recovery of the 3705 or of 
another node in the path 
to the 3705). 





081C0068 A Load !/O operation (to 
a link-attached 3705) has 
failed (a negative response 
has been generated by the 
adjacent 3705). 


081 COO8C The NCP load module has 
an entry point address of 
zero. 

) 081COOAB Load not performed — the 


load subtask has abended. 


User Sense Codes for Request Dump 
Request Units 


) Sense Data Meaning 
081 C0004 A requested 3705 dump 
has been terminated 
, because of a permanent 
) 1/O error on the dump 


file — the dump is partially 
complete and can be for- 
matted and printed. 
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Sense Codes 


138 


Sense Data 


081C0008 


081COO00C 


081C0010 


081C0014 


081C0018 


081C001C 


Meaning 
A requested 3705 dump i ° 
has been terminated ‘S48 
because of a permanent 

3705 1/0 error — the 

dump is partially com- 

plete and can be for- ya 
matted and printed. Sy 


A requested 3705 dump 
has been terminated 
because of a permanent 
1/O error on the dump 
file — the dump data set 
cannot be formatted and 
printed. 


A requested 3705 dump 

has been terminated 2 
because of a permanent 

3705 1/O error — the 

dump data set cannot be 
formatted and printed. 


Unable to successfully 
open the dump data set. 


Dump not performed — ee 
HALT is in progress. 


The dump data set resides 

on a device that is not yo 
supported by the dump \ 
utility program. Or, the 

3705 dump/load/restart 
router (module ISTINCDP) 
has received an input work 
element that containsan = ff _ | 
unrecognized command oe 
code. 


Sense Data 


081C0020 


081COOAB 


Sense Codes 


Meaning 


Unable to successfully 
load a necessary dump 
utility module. 


Dump not performed — 
the dump subtask has 
abended. 


User Sense Codes for Activate Link and 
Deactivate Link Request Units 


Sense Data 


081C0004 


081 C0008 


081CO00C 


081C0010 


081C0028 


081C0030 


081C0034 


Meaning 


Invalid Device Address — 
not three valid hexa- 
decimal digits. 


invalid Device Address — 
specified device does not 
exist (i.e. has not been 
defined in the operating 
system SYSGEN). 


invalid Device Type — 
specified device is not 
of the correct type. 


Device is already allocated 
to another JOB. 


Unable to deallocate 
device. 


No paths are available to 
the device (MVS only). 


Invalid resource type in 
ACF/VTAM resource 
definition table entry 
(RDTE) corresponding to 
device to be allocated. 
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Sense Codes 


Sense Code 
(Hex) 


081D 


O81E 


081F 


0820 


0821 


0822 


140 


Sense Data Meaning 


081C0038 Cannot locate ACF/VTAM 
resource definition table 
entry (RDTE) corre- 
sponding to device to be 
allocated. 


081C003C Device not Usable — 
VARY ONLINE OS/VS 
command has not been 
issued. 


Meaning 


Invalid Station/SSCP ID: The station ID or 
SSCP ID in the request was found to be 
invalid. | 


Session Reference Error: The request con- 
tained reference to a half-session that was 
neither active nor in the process of being 
activated (generally applies to network 
services requests). 


Reserved. 


Control Vector Error: Invalid data for the 
control vector specified by the target 
network address and key. 


Invalid Session Parameters: Session param- 
eters were not valid or not supported by the 
half-session whose activation was requested. 


Link Procedure Failure: A link-level pro- 
cedure has failed due to link equipment 
failure, loss of contact with a link station, 
or an invalid response to a link request. 
(This is not a path error, since the request 
being rejected was delivered to its 
destination.) 


| 


ioe 





Sense Code 


) (Hex) 


0823 


) 0824 


0825 
0826 


0827 


) 0828 


) 0829 


Sense Codes 


Meaning 


Unknown Control Vector: The control 
vector specified by a network address and 
key is not known to the receiver. 


Unit of Work Aborted: The current unit 
of work has been aborted; when synchro- 
nization point protocols are in use, both 
synchronization point managers are to 
revert to the previously committed 
synchronization point. 


Component Not Available: The LU 
component (a device indicated by an FM 
header) is not available. 


FM Function Not Supported: A function 
requested in an FMD RU is not supported 
by the receiver. 


Intermittent Error—Retry Requested: An 
error at the receiver caused an RU to be 
lost. The error is not permanent, and retry 
of the RU (or chain) is requested. 


Reply Not Allowed: A request requires a 
normal-flow reply, but the outbound data 
flow for this half-session is quiesced or shut 
down, and there is no delayed reply 
capability. 


Change Direction Required: A request 
requires a normal-flow reply, but the half- 
duplex flip-flop state is not-send, (S, *R), 
CD was not set on the request, and there is 
no delayed reply capability. 


141 


Sense Codes 


Sense Code 
(Hex) 


082A 


082B 


082C 


082D 


082E 


082F 


0830 


142 


Meaning 


Presentation Space Alteration: Presentation 
space altered by the end user while the half- 
duplex state was not-send, (S, *R); request 
executed. 


Prsentation Space Integrity Lost: Presenta- 
tion space integrity lost (e.g., cleared or 
changed) because of a transient condition— 
for example, because of a transient hard- 
ware error Or an end user action such as 
allowing presentation services to be used by 
the SSCP. (Note: The end-user action 
described under sense codes hex 082A and 
084A is excluded here.) 


Resource-Sharing Limit Reached: The 
request received from an SSCP was to 
activate a half-session, a link, or a procedure, 
when that resource was at its share limit. 


LU Busy: The LU resources needed to 
process the request are being used; for 
example, the LU resources needed to 
process the request received from the SSCP 
are being used for the LU-LU session. 


Intervention Required at LU Subsidiary 

Device: A condition requiring intervention, 
such as out of paper, or power-off, or cover 
interlock open, exists at a subsidiary device. 


Request Not Executable because of LU 
Subsidiary Device: The requested function 
cannot be executed, due to a permanent 
error condition in one or more of the 
receiver's subsidiary devices. 


Reserved. 


a 





Sense Code 
~ ) (Hex) 
| 0831 
) 0832 

0833 


) 0834 


Sense Codes 


Meaning 


LU Component Disconnected: An LU 
component is not available because of 
power off or some other disconnecting 
condition. 


Invalid Count Field: A count field con- 
tained in the request indicates a value too 
long or too short to be interpreted by the 
receiver, or the count field is inconsistent 
with the length of the remaining fields. 
Bytes 2 and 3 following the sense code are 
not used for user-defined data; they contain 
a binary count that indexes (zero-origin) the 
first byte of the invalid count field. 


Invalid Parameter (with Pointer and 
Complemented Byte): One or more 
parameters contained in fixed- or variable- 
length fields of the request are invalid or not 
supported by the NAU that received the 
request. Bytes 2 and 3 following the sense 
code are not used for user-defined data. 
Byte 2 contains a binary value that indexes 
(zero-origin) the first byte that contained an 
invalid parameter. Byte 3 contains a trans- 
form of the first byte that contained an 
invalid parameter: the bits that constitute 
the one or more invalid parameters are 
complemented, and all other bits are copied. 


RPO Not Initiated: A power-off procedure 
for the specified node was not initiated 
because one or more other SSCPs have con- 
tacted the node, or because a CONTACT, 
DUMP, IPL, or DISCONTACT procedure is 
in progress for that node. 
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Sense Codes 


Sense Code 
(Hex) 


0835 


0836 


0837 


0838 


0839 


083A 


144 


Meaning 


Invalid Parameter (with Pointer Only): The 
request contained a fixed- or variable-length 
field whose contents are invalid or not 
supported by the NAU that received the 
request. Bytes 2 and 3 following the sense 
code are not used for user-defined data; 
they contain a 2-byte binary count that 
indexes (zero-origin) the first byte of the 
fixed- or variable-length field having invalid 
contents. 


PLU/SLU Specification Mismatch: Fora 
specified LU-LU session, both the origin 
LU (OLU) and the destination LU (DLU) 
have only the primary capability or have 
only the secondary capability. 


Queuing Limit Exceeded: For an LU-LU 
session-initiation request (INIT, CDINIT, 
or INIT-OTHER-CD) specifying (1) Initiate 
or Queue (if Initiate not possible) or (2) 
Queue Only, the queuing limit of either the 
OLU or the DLU, or both, was exceeded. 


Reserved. 


LU-LU or SSCP-LU Session Being Taken 
Down: At the time an LU-LU session- 
initiation or termination request is received, 
the SSCP of at least one of the LUs is either 
processing a CDTAKED request or is in the 
process of deactivating the associated 
SSCP-LU session. 


LU Not Enabled: At the time an LU-LU 
session-initiation request is received at the 
SSCP, at least one of the two LUs, although 
having an active session with its SSCP, is not 
ready to accept CINIT or BIND requests. 


—_ 
Nacy 








Sense Code 
(Hex) 


083C 


083D 


O83E 
083F 


Sense Codes 


Meaning 


Invalid PCID: An invalid PCID was 
received, e.g., one containing an invalid 
network address of the SSCP of the 
initiating LU (ILU) or terminating LU 
(TLU), has been received in CDINIT, 
INIT-OTHER-CD, CDTERM, or 
TERM-OTHER-CD; or a PCID that does 
not identify a previously queued request 
has been received in CDINIT (Dequeue) 
or INIT-OTHER-CD (Dequeue); or, a 
PCID that cannot be associated with the 
PCID of any previously processed CDINIT 
has been received on CDCINIT. 


Domain Takedown Contention: While 
waiting for a response to a CDTAKED, a 
CDTAKED request is received by the SSCP 
containing the SSCP-SSCP primary half- 
session. Contention is resolved by giving 
preference to the CDTAKED sent by the 
primary half-session. 


Dequeue Retry Unsuccessful—Removed 
from Queue: The SSCP cannot successfully 
honor a CDINIT (Dequeue) request (which 
specifies ‘‘leave on queue if dequeue-retry 
is unsuccessful’’) to dequeue and process a 
previously queued CDINIT request (e.g., 
because the LU in its domain is still not 
available for the specified session), and 
removes the queued CDINIT request from 
its queue. 


Reserved. 


Terminate Contention: While waiting for 

a response to a CDTERM, a CDTERM is 
received by the SSCP of the SLU. Con- 
tention is resolved by giving preference to 
the CDTERM sent by the SSCP of the SLU. 
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Sense Codes 


Sense Code 
(Hex) 


0840 


0841 


0842 


146 


Meaning 


Procedure Invalid for Resource: The 
named procedure is not supported in the 
receiver for this type of resource (e.g., (1) 
SETCV specifies boundary function support 
for a type 1 node but the capability is not 
supported by the receiving node, or (2) the 
PU receiving an EXECTEST or TESTMODE 
is not the primary PU for the target link). 


Duplicate Network Address: In across- 
domain LU-LU session initiation request, 
the SSCP of the DLU determines that the 
OLU network address specified in the 
CDINIT request is a duplicate of an LU 
network address assigned to a different LU 
name. 


SSCP-SSCP Session Not Active: The SSCP- 
SSCP session, which is required for the 
processing of a network services request, is 
not active; e.g., at the time an LU-LU 
session-initiation or termination request is 
received, at least one of the following con- 
ditions exists: 


@ The SSCP of the ILU and the SSCP of 
the OLU do not have an active session 
with each other, and therefore INIT- 
OTHER-CD cannot flow. 


@ The SSCP of the TLU and the SSCP of 
the OLU do not have an active session 
with each other, and therefore TERM- 
OTHER-CD cannot flow. 


e The SSCP of the OLU and the SSCP of 
the DLU do not have an active session 
with each other, and therefore CDINIT 
or CDTERM cannot flow. 


Sha 





Sense Code 
(Hex) 


) 0843 


0844 





0845 


0847 


Sense Codes 


Meaning 


Required FMDS Synchronization Not 
Supplied: For example, a secondary LU 
(LU-LU session type 2 or 3) received a 
request with Write Control Code = Start 
Print, along with ROE and CD. 


Initiation Dequeue Contention: While 
waiting for a response to a CDINIT 
(Dequeue), a CDINIT (Dequeue) is 
received by the SSCP of the SLU. 
Contention is resolved by giving preference 
to the CDINIT (Dequeue) sent by the 
SSCP of the SLU. 


Permission Rejected—SSCP Will Be 
Notified: The receiver has denied an 
implicit or explicit request of the sender; 
when sent in response to BIND, it implies 
that the secondary LU will notify the SSCP 
(via NOTIFY vector key hex OC) when a 
BIND can be accepted, and the SSCP of the 
SLU supports the notification. (See the 
hex O80A sense code for a contrasting 
response.) 


ERP Request Forthcoming: The received 
request was rejected for a reason to be 
specified in a forthcoming request. 


Restart Mismatch: Sent in response to 
STSN or SDT or BIND to indicate that the 
secondary half-session is trying to execute a 
resynchronizing restart but has received 
insufficient or incorrect information. 


Cryptography Function Inoperative: The 
receiver of a request was not able to 
decipher the request because of a malfunc- 
tion in its cryptography facility. 
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Sense Codes 


Sense Code 
(Hex) 


0849 


084A 


084B 


084C 


084D 


148 


Meaning 
Reserved. 


Presentation Space Alteration: The presen- 
tation space was altered by the end user 
while the half-duplex state was not-send, 
(S, *R); request not executed. 


Requested Resources Not Available: 
Resources named in the request, and 
required to honor it, are not currently 
available. It is not known when the 
resources will be made available. 


Bytes 2 and 3 following the sense code are 
not used for user-defined data; they contain 
sense-code-specific information. Settings 
allowed are: 


0000 Requested resources are not 
available. 


6022 The resource identified by the 
destination program name (DPN) is 
not supported. 


6003 The resource identified by the 
primary resource name (PRN) is 
not supported. 


Permanent Insufficient Resource: Receiver 
cannot act on the request because resources 
required to honor the request are perma-: 
nently unavailable. 


Invalid Session Parameters—BF: Session 
parameters were not valid or were un- 
acceptable by the boundary function. Bytes 
2 and 3 following the sense code contain a 
binary count that indexes (zero-origin) the 
first byte of the fixed- or variable-length 
field having invalid contents. 
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| ) (Hex) 





Sense Code 


O84E 


084F 


0850 


0851 


0852 


0853 


Sense Codes 


Meaning 


Invalid Session Parameters: A positive 
response to an activation request (e.g., 
BIND) was received and was changed to 

a negative response due to invalid session 
parameters carried in the response. The 
services manager receiving the response will 
send a deactivation request for the corre- 
sponding session. 


Reserved. 


Link not capable of IPL: An IPL, dump, or 
Remote Power Off (RPO) cannot be per- 
formed through the addressed link station 
because of the current definition of the 
hardware configuration of its associated 
link. 


Session Busy: Another session that is 
needed to complete the function being 
requested on this session (e.g., to forward 
an NS RU embedded in a FORWARD 
request) is temporarily unavailable. 


Session with Larger Activation Request 
Sequence Identifier Already Active: A 
session has already been activated for the 
subject destination-origin pair by a session- 
activation request that carried a larger 
activation request identifier than the current 
request; the current request (ACTPU or 
ACTCDR») is refused. 


Terminate (Cleanup) Required: The SSCP 
cannot process the termination request, as 
it requires cross-domain SSCP-SSCP services 
that are not available. (The corresponding 
SSCP-SSCP session is not active.) Terminate 
(Cleanup) is required. 
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Sense Codes 


Sense Code 
(Hex) 


0854—0855 


0856 


0857 


0858 


0859 


O85A—O085F 
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Meaning 
Reserved. 


SSCP-SSCP Session Lost: Carried in the 
sense data field ina NOTIFY or NSPE sent 
to an ILU or SSCP (ILU) to indicate that 
the activation of the LU-LU session either 
cannot be completed or is uncertain because 
the SSCP-SSCP session between the two 
domains has been lost. (This sense code 
appears only in NOTIFY or NSPE, not ina 
negative response. Another sense code, hex 
0842, is used on a negative response to 
signal the condition when the condition is 
known at the time the response, e.g., to 
INIT, is prepared.) 


SSCP-LU Session Not Active: The SSCP-LU 
session, required for the processing of a 
request, is not active; e.g., in processing 
REQECHO, the SSCP did not have an active 
session with the target LU named in the 
REQECHO RU. 


Reserved. 


REQECHO Data Length Error: The speci- 
fied length of data to be echoed (in 
REQECHO) violates the maximum RU 
size limit for the target LU. 


Reserved. 
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Sense Code 
(Hex) 


s ’ 0860 





0861 


0862 


Sense Codes 


Meaning 


Function Not Supported—Continue 
Session: The function requested is not 
supported; the function may have been 
specified by a request code or some other 
field, control character, or graphic character 
inan RU. Bytes 2-3 following the sense 
code are not used for user-defined data; 
they contain a 2-byte binary count that 
indexes (zero-origin) the first byte in which 
an error was detected. This sense code is 
used to request that the session continue, 
thereby ignoring the error. 


Invalid COS Name: The class of service 
(COS) name, either specified by the ILU 

or generated by the SSCP of the SLU from 
the mode table is not in the “COS name to 
VR identifier’ table used by the SSCP of 
the PLU. Bytes 2 and 3 following the sense 
code contain hex 0000 if the COS name was 
generated by the SSCP or hex 0001 if 
specified by the ILU. 


Medium Presentation Space Recovery: An 
error has occurred on the current presenta- 
tion space. Recovery consists of restarting 
at the top of the current presentation space. 
The sequence number returned is of the RU 
in effect at the top of the current presenta- 
tion space. Bytes 2 and 3 following the 
sense code contain the byte offset from the 
beginning of the RU to the first byte of the 
RU that is displayed at the top of the 
current presentation space. 


Referenced Local Character Set Identifier 


(LCID) Not Found: A referenced character 
set does not exist. 
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Sense Code 
(Hex) 


0864 


0865 


0866 


0867 


0868 


0869 


0870 


0871 


0872 


0873 


0874 
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Meaning 


Function Abort: A loop will occur upon 
reexecution; the request sender should not 
send the same data. 


Function Abort: Sender is responsible to 
detect the loop. 


Function Abort: Receiver is responsible to 
detect the loop. 


Sync Event Response: Indicates a negative 
response to a synchronization event. 


No Panels Loaded: Referenced format not 
found because no panels are loaded for the 
display. 


Panel Not Loaded: The referenced panel is 
not loaded for the display. 


Reserved. 


Read Partition State Error: A Read Partition 
structured field was received while the dis- 
play was in the retry state. 


Orderly Deactivation Refused: An NC __ 
DACTVR (Orderly) request has been 
received, but sessions are assigned to the VR 
and it will not be deactivated. 


Virtual Route Not Defined: There is no 
explicit route number (ERN) designated to 
support this virtual route number (VRN). 


ER Not ina Valid State: The ER supporting 
the requested VR is not in a state allowing 
VR activation. 


a _ 
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Sense Code 
(Hex) 


0875 


0876 


0877 


0878 


0879 


087A 


Sense Codes 


Meaning 


Incorrect or Undefined Explicit Route 
Requested: The reverse ERNs specified 

in the NC_ ACTVR do not contain the ERN 
defined to be used for the VR requested, 

or the ERN designated to be used for the 
VR is not defined. 


Nonreversible Explicit Route Requested: 
The ERN used by the NC__ACTVR does 
not use the same sequence of transmission 
groups (in reverse order) as the ERN that 
should be used for the RSP (NC_ACTVR). 


Reserved. 


Insufficient Storage: The storage required 
for a data format is not available. 


Storage Medium Error: A permanent error 
has occurred involving a storage medium. 


Format Processing Error: A processing 
error occurred during data formatting. 
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Sense Codes 


Request Error (Category Code Hex 10) 


This category indicates that the RU was delivered to the 
intended half-session component, but could not be inter- 
preted or processed. This condition represents a mismatch 
of half-session capabilities. 


Sense Code 

(Hex) Meaning 

1001 RU Data Error: Data in the request RU 
is not acceptable to the receiving FMDS 
component; for example, a character code 
is not in the set supported, a formatted 
data field is not acceptable to presentation 
services, or a required name in the request 
has been omitted. 

1002 RU Length Error: The request RU was 
too long or too short. 

1003 Function Not Supported: The function 


requested is not supported. The function 
may have been specified by a formatted 
request code, a field in an RU, or a control 
character. 


Bytes 2 and 3 following the sense code are 
not used for user-defined data; they con- 
tain sense-code-specific information. 
Settings allowed are: 


0000 _ ~=—s- Function requested is not 
supported. 


6022 The resource identified by the 
destination program name (DPN) 
is not supported. | 

6003 The resource identified by the 
primary resource name (PRN) 
is not supported. 


(Note: This code can also be used 
instead of sense code hex 0826.) 
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Sense Code 
(Hex) 


1004 


1005 


1006 


1007 


1008 


1009 


Sense Codes 


Meaning 
Reserved. 


Parameter Error: A parameter modifying a 
contro! function is invalid, or outside the 
range allowed by the receiver. 


Reserved. 


Category Not Supported: DFC, SC, NC, 
or FMD request was received by a half- 
session not supporting any requests in that 
category; or an NS request with byte O was 
not set to a defined value, or byte 1 was 
not set to an NS category supported by the 
receiver. 


Invalid FM Header: The FM header was not 
understood or translatable by the receiver, 
or an FM header was expected but not 
present. 


Bytes 2 and 3 following the sense code are 
not used for user-defined data; they contain 
sense-code-specific information as defined in 
Systems Network Architecture Sessions 
between Logical Units. 


Format Group Not Selected: No format 
group was selected before issuing a Present 
Absolute or Present Relative Format 
structured field to a display. 
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Sense Codes 


State Error (Category Code Hex 20) 


This category indicates a sequence number error, or an RH or 
RU that is now allowed for the receiver's current session 
control or data flow control state. These errors prevent 
delivery of the request to the intended half-session 
component. 


Modifier 
(Hex) Meaning 


2001 Invalid Sequence Number: Sequence 
number received on normal-flow request 
was not 1 greater than the last. 


2002 Chaining Error: Error in the sequence of 
the chain indicator settings (BCI, ECI), 
such as first, middle, first. 


2003 Bracket Error: Error resulting from failure 
of sender to enforce bracket rules for 
session. (This error does not apply to con- 
tention or race conditions.) 


2004 Direction Error: Error resulting from a 
normal-flow request received while the half- 
duplex flip-flop state was not-receive, 
(*S,R). (Contrast this sense code with 
hex 081B, which signals a race condition.) 


2005 Data Traffic Reset: An FMD or normal- 
flow DFC request received by a half-session 
whose session-activation state was active, 
but whose data-traffic state was not active. 


2006 Data Traffic Quiesced: An FMD or DFC 
request received from a half-session that has 
sent Quiesce Complete or Shutdown 
Complete and has not responded to Release 
Quiesce. 
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Modifier 
(Hex) 


2007 


2008 


2009 


200A 


200B 


200C 


200D 


Sense Codes 


Meaning 


Data Traffic Not Reset: A session contro! 
request (e.g., STSN), allowed only while the 
data traffic state is reset, was received while 
the data-traffic state was not reset. 


No Begin Bracket: A BID or an FMD 
request specifying BBI=BB was received 
after the receiver had previously sent a 
positive response to Bracket Initiation 
Stopped. 


Session Control Protocol Violation: An SC 
protocol has been violated; a request, 
allowed only after a successful exchange 

of an SC request and its associated positive 
response, has been received before such 
successful exchange has occurred (e.g., an 
FMD request has preceded a required 
Cryptography Verification request). The 
request code of the particular SC request or 
response required, or hex OO if undeter- 
mined, appears in the fourth byte of the 
sense data. There is no user data associated 
with this sense code. 


Immediate Request Mode Error: The 
immediate request mode protocol has been 
violated by the request. 


Queued Response Error: The queued 
response protocol has been violated by a 
request, i.e., QRI=QR when an outstanding 
request had QRI=QR. 


ERP Sync Event Error: The ERP synchro- 
nization event protocol has been violated. 


Response Owed before Sending Request: 
An attempt has been made in half-duplex 
(flip-flop or contention) send/receive mode 
to send a normal-flow request when a 
response to a previously received request 
has not yet been sent. 
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Sense Codes 


RH Usage Error (Category Code Hex 40) 


This category indicates that the value of a field or combina- 
tion of fields in the RH violates architectural rules or 
previously selected BIND options. These errors prevent 
delivery of the request to the intended half-session com- 
ponent and are independent of the current states of the 
session. They may result from the failure of the sender to 
enforce session rules. Detection by the receiver of each of 
these errors is optional. 


Sense Code 
(Hex) Meaning 


4001 Invalid SC or NC RH: The RH of a session 
control (SC) or network control (NC) 
request was invalid. For example, an SC 
RH with pacing request indicator set to 1 
is invalid. 


4002 Reserved. 


4003 BB Not Allowed: The begin bracket indi- 
cator (BBI) was specified incorrectly, e.g., 
BBI=BB with BCI=BC. 


4004 EB Not Allowed: The end bracket indicator 
(EB!) was specified incorrectly, e.g., 
EBI=EB with BCI=BC, or by the primary 
half-session when only the secondary may 
send EB, or by the secondary when only the 
primary may send EB. 


4005 Incomplete RH: Transmission shorter than 
full TH-RH. 


4006 Exception Response Not Allowed: 
Exception response was requested when 
not permitted. 


4007 Definite Response Not Allowed: Definite 
response was requested when not permitted. 
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Sense Code 
(Hex) 


4008 


4009 


400A 


400B 


400C 


400D 


400E 


400F 


Sense Codes 


Meaning 


Pacing Not Supported: The pacing indi- 
cator was set on a request, but the 
receiving half-session or boundary function 
half-session does not support pacing for 
this session. 


CD Not Allowed: The change direction 
indicator (CDI) was specified incorrectly, 
e.g., CDI=CD with ECI=EC, or CDI=CD 
with EBI=EB. 


No-Response Not Allowed: No-response 
was specified on a request when not 
permitted. (Use only on EXR.) 


Chaining Not Supported: The chaining 
indicators (BCI and ECI) were specified 
incorrectly, e.g., chaining bits indicated 
other than (BC, EC), but multiple-request 
chains are not supported for the session or 
for the category specified in the request 
header. 


Brackets Not Supported: The bracket indi- 
cators (BBI and EB!) were specified 
incorrectly, e.g., a bracket indicator was 

set (BBI=BB or EBI=EB), but brackets 

are not used for the session. 


CD Not Supported: The change-direction 
indicator was set, but is not supported. 


Reserved. 
Incorrect Use of Format Indicator: The 
format indicator (FI) was specified 


incorrectly, e.g., Fl was set with BCI=BC, 
or Fl was not set on a DFC request. 
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Sense Code 
(Hex) 


4010 


4011 


4012 


4013 


4014 


4015 


4016 


4017 


160 


Meaning 


Alternate Code Not Supported: The code 
selection indicator (CSI) was set when not 
supported for the session. 


Incorrect Specification of RU Category: 
The RU category indicator was specified 
incorrectly, e.g., an expedited-flow request 
or response was specified with RU category 
indicator = FMD. 


Incorrect Specification of Request Code: 
The request code on a response does not 
match the request code on its corresponding 
request. 


Incorrect Specification of (SDI, RTI): The 
sense data included indicator (SDI) and the 
response type indicator (RT!) were not 
specified properly on a response. The 
proper value pairs are (SDI=SD, 
RTl=negative) and (SDI=SD, RT1=positive). 


Incorrect Use of (DR1!1, DR21, ERI): The 
definite response 1 indicator (DR11), 
definite response 2 indicator (DR21), and 
exception response indicator (ERI) were 
specified incorrectly, e.g.,a CANCEL 
request was not specified with DR1!=DR1, 
DR2!=DR2, and ERI=ER. 


Incorrect Use of ORI: The queued response 
indicator (QR1I) was specified incorrectly, 
e.g., QRI=QR on an expedited-flow request. 


Incorrect Use of EDI: The enciphered data 
indicator (EDI) was specified incorrectly, 
e.g., EDI=ED on a DFC request. 


Incorrect Use of PDI: The padded data 
indicator (PDI) was specified incorrectly, 
e.g., PDI=PD on a DFC request. 
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Sense Codes 
Path Error (Category Code Hex 80) 


This category indicates that the request could not be 
delivered to the intended receiver because of a path outage, 
an invalid sequence of activation requests, or one of the 
listed path information unit (PIU) errors. (Some PIU errors 
fall into other categories, e.g., sequence number errors are 
category hex 20.) A path error received while the session 

is active generally indicates that the path to the session 
partner has been lost. In this case, the NAU services 
manager receiving the -RSP (Path Error) may deactivate 

the affected half-session. 


Sense Code 

(Hex) Meaning 

8001 Intermediate Node Failure: Machine or 
program check in a node providing inter- 
mediate function. A response may not 
be possible. 

8002 Link Failure: Data link failure. 

8003 NAU Inoperative: The NAU is unable to 
process requests or responses, é.g., the 
NAU has been disrupted by an abnormal 
termination. 

8004 Unrecognized Destination Address: A 
node in the path has no routing informa- 
tion for the destination specified by the 
TH. 

8005 No Session: No half-session is active in 


the receiving end node for the indicated 
Origination-destination pair, or no 
boundary function half-session compo- 
nent is active for the origin-destination 
pair in a node providing the boundary 
function. A session-activation request 
is needed. 
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Sense Code 
(Hex) 


8006 


8007 


8008 


8009 


800A 


162 


Meaning 


Invalid FID: Invalid FID for the receiving 
node. It is generally not possible to send a 
response for this exception condition, since 
information (FID, addresses) required to 
generate a response is not available. It is 
logged as an error if this capability exists in 
the receiver. 


Segmenting Error: First BIU segment had 
less than 10 bytes; or mapping field 
sequencing error, such as first, last, middle; 
or segmenting not supported and MPF not 
set to 11. If segmenting is not supported, a 
negative response is returned for the first 
segment only, since this contains the RH. 
Subsequent segments are discarded. 


PU Not Active: The SSCP-PU secondary 
half-session in the receiving node has not 
been activated and the request was not 
ACTPU for this half-session; for example, 
the request was ACTLU from an SSCP 
that does not have an active SSCP-PU 
session with the PU associated with the 
addressed LU. 


LU Not Active: The destination address 
specifies an LU for which the SSCP-LU 
secondary half-session has not been 
activated and the request was not ACTLU. 


Too-Long PIU: Transmission was 
truncated by a receiving node because the 
PIU exceeded a maximum length or 
sufficient buffering was not available. 
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Sense Code 
(Hex) 


800B 


800C 


800D 


800E 


800F 


8010 


8011 


Sense Codes 


Meaning 


Incomplete TH: Transmission received 
was shorter than a TH. It is generally not 
possible to send a response for this excep- 
tion condition, since information (FID, 
addresses) required to generate a response 
is not available. It is logged as an error if 
this capability exists in the receiver. 


DCF Error: The data count field (DFC) 
is inconsistent with the transmission length. 


Lost Contact: Contact with the link station 
for which the transmission was intended has 
been lost, but the link has not failed. If the 
difference between link failure and loss of 
contact is not detectable, link failure 

(hex 8002) is sent. 


Unrecognized Origin: The origin address 
specified in the TH was not recognized. 


Invalid Address Combination: The (DAF’, 
OAF’) (FID2) combination or the LSID 
(FID3) specified an invalid type of session, 
e.g.,a PU-LU combination. 


Segmented RU Length Error: An RU was 
found to exceed a maximum length, or 
required buffer allocation that might cause 
future buffer depletion. 


ER !noperative or Undefined: A PIU was 
received from a subarea node that does not 
support ER and VR protocols, and the 
explicit route to the destination is 
inoperative or undefined. 
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Sense Code 
(Hex) 


8012 


8013 


164 


Meaning 


Subarea PU Not Active or Invalid Virtual 
Route: A session-activation request for a 
peripheral PU or LU cannot be satisfied 
because there is no active SSCP-PU session 
for the subarea node providing boundary 
function support, or the virtual route for 
the specified SSCP-PU_1T1|2 or SSCP-LU 
session is not the same as that used for the 
SSCP-PU session of the PU_1T1|2’s or LU’s 
subarea PU. 


COS Not Available: A session-activation 
request cannot be satisfied because none of 
the virtual routes requested for the session is 
available. This condition may arise because 
each of the specified virtual routes cannot 
be activated for one of the following reasons: 


e The specified virtual route cannot be 
mapped to an explicit route to the 
destination subarea, or the explicit route 
it is mapped to is not defined. 


e The underlying explicit route is not 
operative. 


@ The underlying explicit route is opera- 
tive but cannot be activated. 


e The underlying explicit route is active 
but the virtual route cannot be 
activated. 


e@ The session must be assigned to a virtual 


route with an underlying reverse explicit 
route number of O, but the virtual route 
does not meet this criterion. 
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